# LoreOS ## Instructions for AI Agents - For clean Markdown of any page, append `.md` to the page URL - For section-specific indexes, append `/llms.txt` to any section URL - For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.loreos.app/_mcp/server ## Docs - [LoreOS](https://docs.loreos.app/getting-started/introduction.md): Build AI characters that remember, evolve, and live between messages. - [Why LoreOS](https://docs.loreos.app/getting-started/why-lore-os.md): A managed runtime for characters that remember, evolve, and act in-world. - [Build with a coding agent](https://docs.loreos.app/getting-started/build-with-a-coding-agent.md): The fastest path for Cursor, Claude Code, Codex, Devin, and other coding agents. - [Authentication](https://docs.loreos.app/getting-started/authentication.md): Get a key, then send it on every request. - [Self-serve access](https://docs.loreos.app/getting-started/self-serve-access.md): Workspace setup, agent account tokens, and runtime API keys. - [Go live (production)](https://docs.loreos.app/getting-started/go-live-production.md): Promote your existing app to production — top up, set a cap, activate. Do not create a new app. - [Quickstart](https://docs.loreos.app/getting-started/quickstart.md): Your first character reply in four calls. - [Full developer E2E path](https://docs.loreos.app/getting-started/full-developer-e-2-e-path.md): Import a character bundle, migrate prior chat, publish a graph, chat, and read relationship evidence. - [Deploy a minimal chat app](https://docs.loreos.app/getting-started/deploy-a-minimal-chat-app.md): A no-brainer server-side tutorial from API key to deployed character chat. - [Core concepts](https://docs.loreos.app/getting-started/core-concepts.md): The handful of ideas the whole API is built on. - [Character authoring](https://docs.loreos.app/guides/character-authoring.md): The contract for characters that do not feel flat. - [Recipe: a production-grade dating character](https://docs.loreos.app/guides/recipe-a-production-grade-dating-character.md): A complete, copy-paste body that fills every authoring block, plus the validation traps that bite. - [Errors and retries](https://docs.loreos.app/guides/errors-and-retries.md): Every error an adapter hits, whether to retry it, and the in-product fallback. - [Visual identity: asset spec and readiness](https://docs.loreos.app/guides/visual-identity-readiness-and-probes.md): The exact rules for identity assets, runtime image readiness, and historical request reports. - [Character bundle imports](https://docs.loreos.app/guides/character-bundle-imports.md): Upload a fresh character bundle, or migrate a character plus prior relationship history. - [Replacing your existing chat/completions backend](https://docs.loreos.app/guides/migrating-your-chat-backend.md): Move an app from a synchronous /chat/completions call to LoreOS's async event model — without a UX downgrade. - [Telegram Managed Bots](https://docs.loreos.app/guides/telegram-managed-bots.md): One Telegram contact per user-character relationship. - [Staging keys and repeatable evaluation](https://docs.loreos.app/guides/staging-and-evaluation.md): Use a persistent dev key, then run reproducible character evals from a clean slate. - [Research, evidence, and social handoff](https://docs.loreos.app/guides/research-evidence-and-social-handoff.md): Let external apps ask for content, require proof, commit public-safe state, and read it back. - [Architecture](https://docs.loreos.app/platform/architecture.md): How LoreOS turns API calls into stateful character behavior. - [Workflow engine](https://docs.loreos.app/platform/workflow-engine.md): Governed model workflows, typed state, code gates, and observable character runs. - [Character state](https://docs.loreos.app/platform/character-state.md): Memory, character facts, relationship, and runtime context for believable characters. - [Story Room and life simulation](https://docs.loreos.app/platform/story-room-and-life-simulation.md): Daily state packages for characters that live between messages. - [Proactive messages](https://docs.loreos.app/platform/proactive-messages.md): Let a character reach out first — and test it on demand. - [Event lifecycle and reply timing](https://docs.loreos.app/platform/event-lifecycle-and-reply-timing.md): The exact ordered sequence an adapter sees per message — send, run.status, the reply, settled cost — plus how to handle latency, failures, and process death. - [Visual system](https://docs.loreos.app/platform/visual-system.md): Character identity, visual assets, inventory, and image readiness. - [Delivery, metering, and observability](https://docs.loreos.app/platform/delivery-metering-and-observability.md): Production controls for async character runtimes. - [API Reference](https://docs.loreos.app/api-reference.md): 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)