> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.loreos.app/api-reference/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.loreos.app/_mcp/server.

# API Reference

The LoreOS API is organized by resource. New here? Start with the
**[Quickstart](https://docs.loreos.app/getting-started/quickstart)**. If you want the platform model first, read
**[Why LoreOS](https://docs.loreos.app/getting-started/why-lore-os)** and **[Architecture](https://docs.loreos.app/platform/architecture)**.

**Conventions**

* **Base URL** — `https://api.loreos.app`
* **Auth** — `Authorization: Bearer <your key>` on every request
  (see [Authentication](https://docs.loreos.app/getting-started/authentication))
* **Envelope** — responses are `{ schema_version, data, next_actions }`;
  errors are `{ detail: { code, message, fix } }` (read `body.detail.code`)
* **Async replies** — send a message, then read the reply from the session's events
  (see [Core concepts](https://docs.loreos.app/getting-started/core-concepts))
* **Errors** — `{ detail: { code, message, fix } }`; which codes you'll hit, whether each
  is retryable, and the in-product fallback are in the
  [Errors and retries](https://docs.loreos.app/guides/errors-and-retries) catalog

## Public surface: only `/v1/*`

`/v1/*` is the **only** public, supported surface. Build your app against it exclusively.

The LoreOS server also hosts internal surfaces — most visibly `/admin/*` (the internal
operator cockpit) and `/cbt/*` (an internal user-facing chat surface). **These are not for
tenant apps.** They are unversioned, unscoped to your app, may change or disappear without
notice, and are not covered by this documentation. You may see them if you dump the raw
`/openapi.json` (it describes the whole server), but the published API Reference and SDKs
deliberately expose only `/v1`. If you find yourself reaching for an `/admin` or `/cbt`
route, the capability you want is either already on `/v1` or is not yet a supported
product surface — ask us rather than calling an internal route.

> **Warning**
>
> **Stability: preview.** `/v1` is versioned via the `schema_version` field on every
> success envelope and may evolve during preview. We add fields additively (clients
> should ignore unknown fields), but watch `schema_version` and re-check the OpenAPI
> when it changes. Account-plane setup routes for coding agents are documented in
> [Self-serve access](https://docs.loreos.app/getting-started/self-serve-access) and
> `GET /v1/llms.txt`, but are intentionally kept out of the generated runtime API
> Reference/SDK for now. Treat `lat_...` account tokens and app runtime keys as
> different credentials. Do not depend on `/admin` or `/cbt` behavior at all.

## Source of truth: which artifact is authoritative for what

LoreOS publishes the contract in a few forms; each is authoritative for a different thing.
When they appear to disagree, prefer them in this order:

| Artifact                                                   | Authoritative for                                                                                                                             | Audience                                    |
| ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
| **OpenAPI** — `GET https://api.loreos.app/v1/openapi.json` | The exact public **/v1** request/response schema — endpoints, fields, types, enums. This is the schema source of truth for tenant apps.       | Codegen, SDKs, request validation           |
| **`GET /v1/describe`**                                     | The **product / capability map** — what resources exist, how they fit together, the integration flow, and the authoring contract at a glance. | A coding agent learning the surface         |
| **`GET /v1/llms.txt`**                                     | An agent **quick-start guide** — the 3-calls-plus-poll path in plain text, designed to be the first context you hand an LLM.                  | An agent making its first calls             |
| **`docs.loreos.app`** (this site)                          | **Narrative + guides** — concepts, recipes, tutorials, and the reasoning behind the contract.                                                 | Humans and agents reading for understanding |

Because the preview contract may change (tracked by `schema_version`), **pin your
generated client to the OpenAPI schema** and regenerate when `schema_version` moves, rather
than hand-coding request shapes from the narrative docs.

**Sections**

* **Sandbox and reference** — issue a capped demo key and fetch the public OpenAPI
  schema.
* **Characters** — create and manage your characters; check readiness.
* **Imports** — stage one reviewable character bundle for either a fresh authored
  character or a transcript migration, then commit it into runtime state.
* **Character World** — upload or validate relationship graphs, manage NPCs, publish
  graph versions, author storylines, and steer daily arc influences.
* **Research and evidence** — submit evidence, run research, review candidates, and commit
  public-safe state updates.
* **Visual assets** — give a character a face, wardrobe, and accessories; probe and
  generate images.
* **Sessions** — run conversations: start a session, send messages, read replies.
* **Relationship evidence** — read public-safe snapshots, memories, open loops, life feed,
  identity continuity, reach-out reasons, proactive preferences, Telegram binding, and
  opt-in relationship scores.
* **End-users** — list your app's end-users, read one user, inspect that user's sessions,
  and manage usage/caps by `external_user_ref`.
* **Delivery channels** — connect Telegram. Use the BYO bot-token path when you
  already have one character bot. Use the official Managed Bots path when your
  product should create one Telegram contact per user-character relationship.
* **Evals** — check a character's quality before you ship.
* **Observability** — inspect redacted health, timeline, trace, delivery, runs, metrics,
  and rollback/version surfaces for app-owned resources.
* **Account** — your app identity, usage, and rates.

Character authoring itself is a guide-level concept, not a separate API Reference section:
use typed fields on `POST /v1/characters` and `PATCH /v1/characters/{slug}` for visible
bio, interests, voice, greeting, life rhythm, world context, relationship posture, and
baseline emotion.

> REST over HTTPS, one envelope, Bearer auth.


## API Docs

- API Reference > Sandbox and Reference [Demo Sandbox Availability](https://docs.loreos.app/api-reference/sandbox-and-reference/demo-sandbox-availability.md)
- API Reference > Sandbox and Reference [Create a demo sandbox key](https://docs.loreos.app/api-reference/sandbox-and-reference/demo-sandbox-key.md)
- API Reference > Sandbox and Reference [Get the public OpenAPI schema](https://docs.loreos.app/api-reference/sandbox-and-reference/openapi-json.md)
- API Reference > Characters [List characters](https://docs.loreos.app/api-reference/characters/list-characters.md)
- API Reference > Characters [Create a character](https://docs.loreos.app/api-reference/characters/create-character.md)
- API Reference > Characters [Bulk Create Characters](https://docs.loreos.app/api-reference/characters/bulk-create-characters.md)
- API Reference > Characters [Validate Character](https://docs.loreos.app/api-reference/characters/validate-character.md)
- API Reference > Characters [Character Authoring Limits](https://docs.loreos.app/api-reference/characters/character-authoring-limits.md)
- API Reference > Characters [Get a character](https://docs.loreos.app/api-reference/characters/get-character.md)
- API Reference > Characters [Delete a character](https://docs.loreos.app/api-reference/characters/delete-character.md)
- API Reference > Characters [Update a character](https://docs.loreos.app/api-reference/characters/update-character.md)
- API Reference > Characters [Character Readiness](https://docs.loreos.app/api-reference/characters/character-readiness.md)
- API Reference > Characters [Character Runtime Preview](https://docs.loreos.app/api-reference/characters/character-runtime-preview.md)
- API Reference > Characters [Rename Character](https://docs.loreos.app/api-reference/characters/rename-character.md)
- API Reference > Characters [Archive a character](https://docs.loreos.app/api-reference/characters/archive-character.md)
- API Reference > Characters [Restore a character](https://docs.loreos.app/api-reference/characters/restore-character.md)
- API Reference > Characters [Get character deletion status](https://docs.loreos.app/api-reference/characters/character-deletion-status.md)
- API Reference > Characters [List Character Localizations](https://docs.loreos.app/api-reference/characters/list-character-localizations.md)
- API Reference > Characters [Get Character Localization](https://docs.loreos.app/api-reference/characters/get-character-localization.md)
- API Reference > Characters [Patch Character Localization](https://docs.loreos.app/api-reference/characters/patch-character-localization.md)
- API Reference > Characters [Activate Character Features](https://docs.loreos.app/api-reference/characters/activate-character-features.md)
- API Reference > Characters [Character Feature Status](https://docs.loreos.app/api-reference/characters/character-feature-status.md)
- API Reference > Characters [Deactivate Character Features](https://docs.loreos.app/api-reference/characters/deactivate-character-features.md)
- API Reference > Characters [Block an end-user from a character](https://docs.loreos.app/api-reference/characters/block-character-for-user.md)
- API Reference > Characters [Unblock an end-user from a character](https://docs.loreos.app/api-reference/characters/unblock-character-for-user.md)
- API Reference > Characters [List Story Room Runs](https://docs.loreos.app/api-reference/characters/list-story-room-runs.md)
- API Reference > Characters [Create Story Room Run](https://docs.loreos.app/api-reference/characters/create-story-room-run.md)
- API Reference > Characters [Get Story Room Run](https://docs.loreos.app/api-reference/characters/get-story-room-run.md)
- API Reference > Characters [List Story Room Open Loops](https://docs.loreos.app/api-reference/characters/list-story-room-open-loops.md)
- API Reference > Characters [List Story Room Candidates](https://docs.loreos.app/api-reference/characters/list-story-room-candidates.md)
- API Reference > Characters [Approve Story Room Candidate](https://docs.loreos.app/api-reference/characters/approve-story-room-candidate.md)
- API Reference > Characters [Reject Story Room Candidate](https://docs.loreos.app/api-reference/characters/reject-story-room-candidate.md)
- API Reference > Imports [List character imports](https://docs.loreos.app/api-reference/imports/list-imports.md)
- API Reference > Imports [Create a character import](https://docs.loreos.app/api-reference/imports/create-import.md)
- API Reference > Imports [Get a character import](https://docs.loreos.app/api-reference/imports/get-import.md)
- API Reference > Imports [Delete a character import](https://docs.loreos.app/api-reference/imports/delete-import.md)
- API Reference > Imports [Preview a character import](https://docs.loreos.app/api-reference/imports/get-import-preview.md)
- API Reference > Imports [Review a character import item](https://docs.loreos.app/api-reference/imports/patch-import-review-item.md)
- API Reference > Imports [Commit a character import](https://docs.loreos.app/api-reference/imports/commit-import.md)
- API Reference > Character World [Get app world](https://docs.loreos.app/api-reference/character-world/get-world.md)
- API Reference > Character World [Get app world graph](https://docs.loreos.app/api-reference/character-world/get-world-graph.md)
- API Reference > Character World [Validate app world graph](https://docs.loreos.app/api-reference/character-world/validate-app-world-graph.md)
- API Reference > Character World [Import app world graph](https://docs.loreos.app/api-reference/character-world/import-app-world-graph.md)
- API Reference > Character World [List app world graph versions](https://docs.loreos.app/api-reference/character-world/list-app-world-graph-versions.md)
- API Reference > Character World [Publish app world graph version](https://docs.loreos.app/api-reference/character-world/publish-app-world-graph-version.md)
- API Reference > Character World [Get character world](https://docs.loreos.app/api-reference/character-world/get-character-world.md)
- API Reference > Character World [Get character world timeline](https://docs.loreos.app/api-reference/character-world/get-character-world-timeline.md)
- API Reference > Character World [List character memory facts](https://docs.loreos.app/api-reference/character-world/get-character-memory-facts.md)
- API Reference > Character World [List character entity memories](https://docs.loreos.app/api-reference/character-world/get-character-entity-memories.md)
- API Reference > Character World [Validate character world graph](https://docs.loreos.app/api-reference/character-world/validate-character-world-graph.md)
- API Reference > Character World [Import character world graph](https://docs.loreos.app/api-reference/character-world/import-character-world-graph.md)
- API Reference > Character World [List character world graph versions](https://docs.loreos.app/api-reference/character-world/list-character-world-graph-versions.md)
- API Reference > Character World [Publish character world graph version](https://docs.loreos.app/api-reference/character-world/publish-character-world-graph-version.md)
- API Reference > Character World [List storylines](https://docs.loreos.app/api-reference/character-world/list-character-storylines.md)
- API Reference > Character World [Create a storyline](https://docs.loreos.app/api-reference/character-world/create-character-storyline.md)
- API Reference > Character World [Get a storyline](https://docs.loreos.app/api-reference/character-world/get-character-storyline.md)
- API Reference > Character World [Update a storyline](https://docs.loreos.app/api-reference/character-world/update-character-storyline.md)
- API Reference > Character World [Activate a storyline](https://docs.loreos.app/api-reference/character-world/activate-character-storyline.md)
- API Reference > Character World [Archive a storyline](https://docs.loreos.app/api-reference/character-world/archive-character-storyline.md)
- API Reference > Character World [List daily arc influences](https://docs.loreos.app/api-reference/character-world/list-character-daily-arc-influences.md)
- API Reference > Character World [Create a daily arc influence](https://docs.loreos.app/api-reference/character-world/create-character-daily-arc-influence.md)
- API Reference > Character World [Get a daily arc influence](https://docs.loreos.app/api-reference/character-world/get-character-daily-arc-influence.md)
- API Reference > Character World [Delete a daily arc influence](https://docs.loreos.app/api-reference/character-world/delete-character-daily-arc-influence.md)
- API Reference > Character World [Update a daily arc influence](https://docs.loreos.app/api-reference/character-world/update-character-daily-arc-influence.md)
- API Reference > Character World [Get character life projection](https://docs.loreos.app/api-reference/character-world/get-character-life.md)
- API Reference > Character World [Get character agenda](https://docs.loreos.app/api-reference/character-world/get-character-agenda.md)
- API Reference > Character World [List character agenda items](https://docs.loreos.app/api-reference/character-world/list-character-agenda-items.md)
- API Reference > Character World [Get character agenda item](https://docs.loreos.app/api-reference/character-world/get-character-agenda-item.md)
- API Reference > Character World [Update character agenda item status](https://docs.loreos.app/api-reference/character-world/update-character-agenda-item.md)
- API Reference > Character World [Get character offscreen heartbeat](https://docs.loreos.app/api-reference/character-world/get-character-offscreen-heartbeat.md)
- API Reference > Character World [List offscreen opportunities](https://docs.loreos.app/api-reference/character-world/list-character-offscreen-opportunities.md)
- API Reference > Character World [List offscreen scenes](https://docs.loreos.app/api-reference/character-world/list-character-offscreen-scenes.md)
- API Reference > Character World [List offscreen deltas](https://docs.loreos.app/api-reference/character-world/list-character-offscreen-deltas.md)
- API Reference > Character World [List life-event candidates](https://docs.loreos.app/api-reference/character-world/list-character-life-event-candidates.md)
- API Reference > Character World [Approve a life-event candidate](https://docs.loreos.app/api-reference/character-world/approve-character-life-event-candidate.md)
- API Reference > Character World [Approve a life-event candidate with edits](https://docs.loreos.app/api-reference/character-world/approve-character-life-event-candidate-with-edits.md)
- API Reference > Character World [Reject a life-event candidate](https://docs.loreos.app/api-reference/character-world/reject-character-life-event-candidate.md)
- API Reference > Character World [Request life-event alternatives](https://docs.loreos.app/api-reference/character-world/request-alternatives-for-character-life-event-candidate.md)
- API Reference > Character World [List NPCs](https://docs.loreos.app/api-reference/character-world/list-character-npcs.md)
- API Reference > Character World [Create an NPC](https://docs.loreos.app/api-reference/character-world/create-character-npc.md)
- API Reference > Character World [List supporting cast](https://docs.loreos.app/api-reference/character-world/list-character-supporting-cast.md)
- API Reference > Character World [List supporting-cast candidates](https://docs.loreos.app/api-reference/character-world/list-character-supporting-cast-candidates.md)
- API Reference > Character World [Promote a supporting-cast candidate](https://docs.loreos.app/api-reference/character-world/promote-character-supporting-cast.md)
- API Reference > Character World [Dismiss a supporting-cast candidate](https://docs.loreos.app/api-reference/character-world/dismiss-character-supporting-cast.md)
- API Reference > Character World [Request supporting-cast review](https://docs.loreos.app/api-reference/character-world/request-review-character-supporting-cast.md)
- API Reference > Character World [Get an NPC](https://docs.loreos.app/api-reference/character-world/get-character-npc.md)
- API Reference > Character World [Delete an NPC](https://docs.loreos.app/api-reference/character-world/delete-character-npc.md)
- API Reference > Character World [Update an NPC](https://docs.loreos.app/api-reference/character-world/update-character-npc.md)
- API Reference > Character World [Get NPC relationship](https://docs.loreos.app/api-reference/character-world/get-character-npc-relationship.md)
- API Reference > Character World [Set NPC relationship](https://docs.loreos.app/api-reference/character-world/put-character-npc-relationship.md)
- API Reference > Character World [Delete NPC relationship](https://docs.loreos.app/api-reference/character-world/delete-character-npc-relationship.md)
- API Reference > Character World [Update NPC relationship](https://docs.loreos.app/api-reference/character-world/patch-character-npc-relationship.md)
- API Reference > Research and Evidence [List research runs](https://docs.loreos.app/api-reference/research-and-evidence/list-research-runs.md)
- API Reference > Research and Evidence [Create a research run](https://docs.loreos.app/api-reference/research-and-evidence/create-research-run.md)
- API Reference > Research and Evidence [Enqueue a research query plan](https://docs.loreos.app/api-reference/research-and-evidence/enqueue-research-query-plan.md)
- API Reference > Research and Evidence [Execute a research run](https://docs.loreos.app/api-reference/research-and-evidence/execute-research-run.md)
- API Reference > Research and Evidence [List evidence](https://docs.loreos.app/api-reference/research-and-evidence/list-evidence.md)
- API Reference > Research and Evidence [Submit evidence](https://docs.loreos.app/api-reference/research-and-evidence/create-evidence.md)
- API Reference > Research and Evidence [Create a state candidate from evidence](https://docs.loreos.app/api-reference/research-and-evidence/create-state-candidate-from-evidence.md)
- API Reference > Research and Evidence [List research candidates](https://docs.loreos.app/api-reference/research-and-evidence/list-research-candidates.md)
- API Reference > Research and Evidence [Create a research candidate](https://docs.loreos.app/api-reference/research-and-evidence/create-research-candidate.md)
- API Reference > Research and Evidence [Get a research candidate](https://docs.loreos.app/api-reference/research-and-evidence/get-research-candidate.md)
- API Reference > Research and Evidence [Review a research candidate](https://docs.loreos.app/api-reference/research-and-evidence/review-research-candidate.md)
- API Reference > Research and Evidence [Create a state review](https://docs.loreos.app/api-reference/research-and-evidence/create-state-review.md)
- API Reference > Research and Evidence [Get a state review](https://docs.loreos.app/api-reference/research-and-evidence/get-state-review.md)
- API Reference > Research and Evidence [Commit a state review](https://docs.loreos.app/api-reference/research-and-evidence/commit-state-review.md)
- API Reference > Research and Evidence [Get public slice](https://docs.loreos.app/api-reference/research-and-evidence/get-public-slice.md)
- API Reference > Research and Evidence [List content intents](https://docs.loreos.app/api-reference/research-and-evidence/list-content-intents.md)
- API Reference > Research and Evidence [Create a content intent](https://docs.loreos.app/api-reference/research-and-evidence/create-content-intent.md)
- API Reference > Research and Evidence [Get a content intent](https://docs.loreos.app/api-reference/research-and-evidence/get-content-intent.md)
- API Reference > Research and Evidence [Check content fit](https://docs.loreos.app/api-reference/research-and-evidence/fit-content-intent.md)
- API Reference > Research and Evidence [List mission candidates](https://docs.loreos.app/api-reference/research-and-evidence/list-mission-candidates.md)
- API Reference > Research and Evidence [Create a mission candidate](https://docs.loreos.app/api-reference/research-and-evidence/create-mission-candidate.md)
- API Reference > Research and Evidence [Record a published post](https://docs.loreos.app/api-reference/research-and-evidence/record-published-post-as-evidence.md)
- API Reference > Visual Assets [List Visual Assets](https://docs.loreos.app/api-reference/visual-assets/list-visual-assets.md)
- API Reference > Visual Assets [Upload Visual Asset](https://docs.loreos.app/api-reference/visual-assets/upload-visual-asset.md)
- API Reference > Visual Assets [Register Visual Asset Url](https://docs.loreos.app/api-reference/visual-assets/register-visual-asset-url.md)
- API Reference > Visual Assets [Bulk Register Visual Assets](https://docs.loreos.app/api-reference/visual-assets/bulk-register-visual-assets.md)
- API Reference > Visual Assets [Visual Inventory](https://docs.loreos.app/api-reference/visual-assets/visual-inventory.md)
- API Reference > Visual Assets [Visual Readiness](https://docs.loreos.app/api-reference/visual-assets/visual-readiness.md)
- API Reference > Visual Assets [Get Image Probe](https://docs.loreos.app/api-reference/visual-assets/get-image-probe.md)
- API Reference > Visual Assets [List Image Probes](https://docs.loreos.app/api-reference/visual-assets/list-image-probes.md)
- API Reference > Visual Assets [List Inventory Generations](https://docs.loreos.app/api-reference/visual-assets/list-inventory-generations.md)
- API Reference > Visual Assets [Delete Visual Asset](https://docs.loreos.app/api-reference/visual-assets/delete-visual-asset.md)
- API Reference > Visual Assets [Update Visual Asset](https://docs.loreos.app/api-reference/visual-assets/update-visual-asset.md)
- API Reference > Sessions [List Sessions](https://docs.loreos.app/api-reference/sessions/list-sessions.md)
- API Reference > Sessions [Start a session](https://docs.loreos.app/api-reference/sessions/create-session.md)
- API Reference > Sessions [Send a message](https://docs.loreos.app/api-reference/sessions/send-message.md)
- API Reference > Sessions [Push Context Events](https://docs.loreos.app/api-reference/sessions/push-context-events.md)
- API Reference > Sessions [Control Session Lifecycle](https://docs.loreos.app/api-reference/sessions/control-session-lifecycle.md)
- API Reference > Sessions [Reset a session](https://docs.loreos.app/api-reference/sessions/reset-session.md)
- API Reference > Sessions [Block Session Character](https://docs.loreos.app/api-reference/sessions/block-session-character.md)
- API Reference > Sessions [Report Session](https://docs.loreos.app/api-reference/sessions/report-session.md)
- API Reference > Sessions [Get session events](https://docs.loreos.app/api-reference/sessions/get-events.md)
- API Reference > Sessions [Get session state](https://docs.loreos.app/api-reference/sessions/get-session-state.md)
- API Reference > Sessions [Stream session events](https://docs.loreos.app/api-reference/sessions/stream-events.md)
- API Reference > Sessions [Proactive Test](https://docs.loreos.app/api-reference/sessions/proactive-test.md)
- API Reference > Sessions [Update Proactive Controls](https://docs.loreos.app/api-reference/sessions/update-proactive-controls.md)
- API Reference > Sessions [Proactive Diagnostics](https://docs.loreos.app/api-reference/sessions/proactive-diagnostics.md)
- API Reference > Relationship Evidence [Get relationship scores](https://docs.loreos.app/api-reference/relationship-evidence/get-session-relationship-scores.md)
- API Reference > Relationship Evidence [Export character relationship scores](https://docs.loreos.app/api-reference/relationship-evidence/list-character-relationship-scores.md)
- API Reference > Relationship Evidence [Export external-user relationship scores](https://docs.loreos.app/api-reference/relationship-evidence/list-external-user-relationship-scores.md)
- API Reference > Relationship Evidence [List Session Relationship Context](https://docs.loreos.app/api-reference/relationship-evidence/list-session-relationship-context.md)
- API Reference > Relationship Evidence [Write Session Relationship Context](https://docs.loreos.app/api-reference/relationship-evidence/write-session-relationship-context.md)
- API Reference > Relationship Evidence [Delete Session Relationship Context](https://docs.loreos.app/api-reference/relationship-evidence/delete-session-relationship-context.md)
- API Reference > Relationship Evidence [Get relationship snapshot](https://docs.loreos.app/api-reference/relationship-evidence/get-relationship-snapshot.md)
- API Reference > Relationship Evidence [List session memories](https://docs.loreos.app/api-reference/relationship-evidence/list-session-memories.md)
- API Reference > Relationship Evidence [Create session memory](https://docs.loreos.app/api-reference/relationship-evidence/create-session-memory.md)
- API Reference > Relationship Evidence [Forget all session memories](https://docs.loreos.app/api-reference/relationship-evidence/delete-all-session-memories.md)
- API Reference > Relationship Evidence [Delete session memory](https://docs.loreos.app/api-reference/relationship-evidence/delete-session-memory.md)
- API Reference > Relationship Evidence [Update session memory](https://docs.loreos.app/api-reference/relationship-evidence/update-session-memory.md)
- API Reference > Relationship Evidence [List session open loops](https://docs.loreos.app/api-reference/relationship-evidence/list-session-open-loops.md)
- API Reference > Relationship Evidence [List session life feed](https://docs.loreos.app/api-reference/relationship-evidence/list-session-life-feed.md)
- API Reference > Relationship Evidence [Get session identity continuity](https://docs.loreos.app/api-reference/relationship-evidence/get-session-identity-continuity.md)
- API Reference > Relationship Evidence [List session reachout reasons](https://docs.loreos.app/api-reference/relationship-evidence/list-session-reachout-reasons.md)
- API Reference > Relationship Evidence [Get proactive preferences](https://docs.loreos.app/api-reference/relationship-evidence/get-session-proactive-preferences.md)
- API Reference > Relationship Evidence [Update proactive preferences](https://docs.loreos.app/api-reference/relationship-evidence/update-session-proactive-preferences.md)
- API Reference > Relationship Evidence [Create Telegram bind token](https://docs.loreos.app/api-reference/relationship-evidence/create-session-telegram-bind-token.md)
- API Reference > Relationship Evidence [Create Telegram managed child bot](https://docs.loreos.app/api-reference/relationship-evidence/create-session-managed-telegram-child-bot.md)
- API Reference > Relationship Evidence [Get Telegram binding](https://docs.loreos.app/api-reference/relationship-evidence/get-session-telegram-binding.md)
- API Reference > Relationship Evidence [Delete Telegram binding](https://docs.loreos.app/api-reference/relationship-evidence/delete-session-telegram-binding.md)
- API Reference > End Users [List external users](https://docs.loreos.app/api-reference/end-users/list-external-users.md)
- API Reference > End Users [Get External User](https://docs.loreos.app/api-reference/end-users/get-external-user.md)
- API Reference > End Users [Upsert External User](https://docs.loreos.app/api-reference/end-users/upsert-external-user.md)
- API Reference > End Users [List External User Sessions](https://docs.loreos.app/api-reference/end-users/list-external-user-sessions.md)
- API Reference > End Users [Block an end-user](https://docs.loreos.app/api-reference/end-users/block-external-user.md)
- API Reference > End Users [Unblock an end-user](https://docs.loreos.app/api-reference/end-users/unblock-external-user.md)
- API Reference > End Users [External User Usage](https://docs.loreos.app/api-reference/end-users/external-user-usage.md)
- API Reference > End Users [Set External User Budget](https://docs.loreos.app/api-reference/end-users/set-external-user-budget.md)
- API Reference > End Users [Delete External User](https://docs.loreos.app/api-reference/end-users/delete-external-user.md)
- API Reference > Delivery Channels [Attach a delivery channel](https://docs.loreos.app/api-reference/delivery-channels/register-channel.md)
- API Reference > Delivery Channels [Connect Telegram](https://docs.loreos.app/api-reference/delivery-channels/connect-telegram.md)
- API Reference > Delivery Channels [List Delivery Channels](https://docs.loreos.app/api-reference/delivery-channels/list-delivery-channels.md)
- API Reference > Delivery Channels [List Telegram Managed Bot Requests](https://docs.loreos.app/api-reference/delivery-channels/list-telegram-managed-bot-requests.md)
- API Reference > Delivery Channels [Get Delivery Channel](https://docs.loreos.app/api-reference/delivery-channels/get-delivery-channel.md)
- API Reference > Delivery Channels [Delete Telegram Channel](https://docs.loreos.app/api-reference/delivery-channels/delete-telegram-channel.md)
- API Reference > Delivery Channels [Verify Telegram Channel](https://docs.loreos.app/api-reference/delivery-channels/verify-telegram-channel.md)
- API Reference > Delivery Channels [Disable Telegram Channel](https://docs.loreos.app/api-reference/delivery-channels/disable-telegram-channel.md)
- API Reference > Delivery Channels [Enable Telegram Channel](https://docs.loreos.app/api-reference/delivery-channels/enable-telegram-channel.md)
- API Reference > Evals [List Evals](https://docs.loreos.app/api-reference/evals/list-evals.md)
- API Reference > Evals [Run Eval](https://docs.loreos.app/api-reference/evals/run-eval.md)
- API Reference > Evals [Get Eval](https://docs.loreos.app/api-reference/evals/get-eval.md)
- API Reference > Evals [Create Conversation Eval](https://docs.loreos.app/api-reference/evals/create-conversation-eval.md)
- API Reference > Evals [Get Conversation Eval](https://docs.loreos.app/api-reference/evals/get-conversation-eval.md)
- API Reference > Observability [App Observability Metrics](https://docs.loreos.app/api-reference/observability/app-observability-metrics.md)
- API Reference > Observability [Get session delivery log](https://docs.loreos.app/api-reference/observability/session-delivery.md)
- API Reference > Observability [List session runs](https://docs.loreos.app/api-reference/observability/session-runs.md)
- API Reference > Observability [Get redacted session health](https://docs.loreos.app/api-reference/observability/session-health.md)
- API Reference > Observability [Observability Session Telegram](https://docs.loreos.app/api-reference/observability/session-telegram.md)
- API Reference > Observability [Get redacted offscreen heartbeat](https://docs.loreos.app/api-reference/observability/offscreen-heartbeat.md)
- API Reference > Observability [Get redacted session invariants](https://docs.loreos.app/api-reference/observability/session-invariants.md)
- API Reference > Observability [Get redacted session timeline](https://docs.loreos.app/api-reference/observability/session-timeline.md)
- API Reference > Observability [Get redacted session debug bundle](https://docs.loreos.app/api-reference/observability/session-debug-bundle.md)
- API Reference > Observability [Observability Session Debug Dossier](https://docs.loreos.app/api-reference/observability/session-debug-dossier.md)
- API Reference > Observability [Get redacted turn context](https://docs.loreos.app/api-reference/observability/turn-reply-context.md)
- API Reference > Observability [Session Trace](https://docs.loreos.app/api-reference/observability/session-trace.md)
- API Reference > Observability [List Character Versions](https://docs.loreos.app/api-reference/observability/list-character-versions.md)
- API Reference > Observability [Rollback Character](https://docs.loreos.app/api-reference/observability/rollback-character.md)
- API Reference > Observability [Character Metrics](https://docs.loreos.app/api-reference/observability/character-metrics.md)
- API Reference > Observability [App Metrics](https://docs.loreos.app/api-reference/observability/app-metrics.md)
- API Reference > Account [Get account identity](https://docs.loreos.app/api-reference/account/get-account-me.md)
- API Reference > Account [Get workspace](https://docs.loreos.app/api-reference/account/get-workspace.md)
- API Reference > Account [Create Account Api Key](https://docs.loreos.app/api-reference/account/create-account-api-key.md)
- API Reference > Account [List app API keys](https://docs.loreos.app/api-reference/account/list-account-api-keys.md)
- API Reference > Account [Revoke an API key](https://docs.loreos.app/api-reference/account/revoke-account-api-key.md)
- API Reference > Account [Rotate an API key](https://docs.loreos.app/api-reference/account/rotate-account-api-key.md)
- API Reference > Account [List end-users (account)](https://docs.loreos.app/api-reference/account/list-account-external-users.md)
- API Reference > Account [Get an end-user (account)](https://docs.loreos.app/api-reference/account/get-account-external-user.md)
- API Reference > Account [Upsert an end-user (account)](https://docs.loreos.app/api-reference/account/upsert-account-external-user.md)
- API Reference > Account [Delete an end-user (account)](https://docs.loreos.app/api-reference/account/delete-account-external-user.md)
- API Reference > Account [Set a per-user spend cap (account)](https://docs.loreos.app/api-reference/account/set-account-external-user-budget.md)
- API Reference > Account [Get app usage (account)](https://docs.loreos.app/api-reference/account/get-account-app-usage.md)
- API Reference > Account [Get Account App Message Costs](https://docs.loreos.app/api-reference/account/get-account-app-message-costs.md)
- API Reference > Account [Get app cost summary (account)](https://docs.loreos.app/api-reference/account/get-account-app-cost-summary.md)
- API Reference > Account [List app spend caps](https://docs.loreos.app/api-reference/account/list-account-budget-policies.md)
- API Reference > Account [Set an app spend cap](https://docs.loreos.app/api-reference/account/set-account-app-budget-policy.md)
- API Reference > Account [Create an insufficient-credit test fixture](https://docs.loreos.app/api-reference/account/create-insufficient-credit-fixture.md)
- API Reference > Account [Get app production readiness](https://docs.loreos.app/api-reference/account/get-account-production-readiness.md)
- API Reference > Account [Activate app production](https://docs.loreos.app/api-reference/account/activate-account-production.md)
- API Reference > Account [Get workspace cost summary](https://docs.loreos.app/api-reference/account/get-account-cost-summary.md)
- API Reference > Account [Who am I](https://docs.loreos.app/api-reference/account/me.md)
- API Reference > Account [Update app settings](https://docs.loreos.app/api-reference/account/update-app.md)
- API Reference > Account [Get App Proactive Policy](https://docs.loreos.app/api-reference/account/get-app-proactive-policy.md)
- API Reference > Account [Patch App Proactive Policy](https://docs.loreos.app/api-reference/account/patch-app-proactive-policy.md)
- API Reference > Account [Get app usage](https://docs.loreos.app/api-reference/account/usage.md)
- API Reference > Account [Usage Message Costs](https://docs.loreos.app/api-reference/account/usage-message-costs.md)
- API Reference > Account [Get rate card](https://docs.loreos.app/api-reference/account/rates.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.loreos.app/openapi.json)
- [OpenAPI YAML](https://docs.loreos.app/openapi.yaml)