> For the complete documentation index, see [llms.txt](https://docs.dispach.moeenmahmud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server.md).

# Dispach agent server

- [Liveness, the version, and how many agents are hosted.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/liveness-the-version-and-how-many-agents-are-hosted.md)
- [Whether a turn can be served yet.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/whether-a-turn-can-be-served-yet.md)
- [Whether the process is idle, and when it must next be woken. For an external waker.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/whether-the-process-is-idle-and-when-it-must-next-be-woken-for-an-external-waker.md)
- [Every agent this server knows about, hosted or switched off.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/every-agent-this-server-knows-about-hosted-or-switched-off.md)
- [Create an agent, from answers or from a template, and adopt it into this host, live.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/create-an-agent-from-answers-or-from-a-template-and-adopt-it-into-this-host-live.md)
- [One agent, with its dialect, window, counts and warnings.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/one-agent-with-its-dialect-window-counts-and-warnings.md)
- [Re-read the manifest by replacing the agent with a new instance.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/re-read-the-manifest-by-replacing-the-agent-with-a-new-instance.md)
- [This document.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/this-document.md)
- [A browser reference over this document.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/a-browser-reference-over-this-document.md)
- [The questions creating an agent asks, and whether this server can answer them.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/the-questions-creating-an-agent-asks-and-whether-this-server-can-answer-them.md)
- [The templates an agent can be created from, and the variables each declares.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/the-templates-an-agent-can-be-created-from-and-the-variables-each-declares.md)
- [Which variables the agent's manifest reads, and whether each is set. Never a value.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/which-variables-the-agents-manifest-reads-and-whether-each-is-set-never-a-value.md)
- [Write the agent's credentials into its .env and apply them: reload or adopt.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/write-the-agents-credentials-into-its-env-and-apply-them-reload-or-adopt.md)
- [Switch an agent off durably and drop it from this host now.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/switch-an-agent-off-durably-and-drop-it-from-this-host-now.md)
- [Switch it back on and have this host adopt it.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/switch-it-back-on-and-have-this-host-adopt-it.md)
- [Start a turn. Returns once accepted; the turn runs detached.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/start-a-turn-returns-once-accepted-the-turn-runs-detached.md)
- [One turn's events as SSE, replayed from the start and then live.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/one-turns-events-as-sse-replayed-from-the-start-and-then-live.md)
- [Cooperatively stop a turn this API started.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/cooperatively-stop-a-turn-this-api-started.md)
- [Questions waiting on a person, oldest first.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/questions-waiting-on-a-person-oldest-first.md)
- [Answer one blocked tool call.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/answer-one-blocked-tool-call.md)
- [Every key, live and revoked. Never a secret.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/every-key-live-and-revoked-never-a-secret.md)
- [Mint an operator key. The secret is returned once and never again.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/mint-an-operator-key-the-secret-is-returned-once-and-never-again.md)
- [Revoke a key. A soft delete; the row survives.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/revoke-a-key-a-soft-delete-the-row-survives.md)
- [The subscriptions this credential can see, with their delivery health. Never a secret.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/the-subscriptions-this-credential-can-see-with-their-delivery-health-never-a-secret.md)
- [Subscribe a URL to event types. The signing secret is returned once.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/subscribe-a-url-to-event-types-the-signing-secret-is-returned-once.md)
- [Delete a subscription and anything it still owed.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/delete-a-subscription-and-anything-it-still-owed.md)
- [What every agent in scope cost, per model call, grouped by agent, model, day or sender.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/what-every-agent-in-scope-cost-per-model-call-grouped-by-agent-model-day-or-sender.md)
- [What this agent cost, from the meter.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/what-this-agent-cost-from-the-meter.md)
- [Every turn this agent has taken, newest first, across sessions, paged by \`before\`.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/every-turn-this-agent-has-taken-newest-first-across-sessions-paged-by-before.md)
- [One turn's stored row.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/one-turns-stored-row.md)
- [Conversations, most recently active first.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/conversations-most-recently-active-first.md)
- [One conversation's summary.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/one-conversations-summary.md)
- [Drop a conversation's history, turns and derived index.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/drop-a-conversations-history-turns-and-derived-index.md)
- [A page of a conversation's messages.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/a-page-of-a-conversations-messages.md)
- [Move a session into a declared phase.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/move-a-session-into-a-declared-phase.md)
- [Every schedule, from the store.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/every-schedule-from-the-store.md)
- [Create a schedule. Validated by the manifest's own schedule rules.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/create-a-schedule-validated-by-the-manifests-own-schedule-rules.md)
- [One schedule's row.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/one-schedules-row.md)
- [Delete a schedule the API created.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/delete-a-schedule-the-api-created.md)
- [Replace a schedule the API created.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/replace-a-schedule-the-api-created.md)
- [Fire a schedule now, out of band.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/fire-a-schedule-now-out-of-band.md)
- [Every manifest field this surface may set, what it does, and its current value.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/every-manifest-field-this-surface-may-set-what-it-does-and-its-current-value.md)
- [Set one manifest field, then replace the agent so it takes effect.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/set-one-manifest-field-then-replace-the-agent-so-it-takes-effect.md)
- [Connect or disconnect a channel, and set its credential.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/connect-or-disconnect-a-channel-and-set-its-credential.md)
- [Forget a channel's stored pairing, so the next start offers a new code.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/forget-a-channels-stored-pairing-so-the-next-start-offers-a-new-code.md)
- [The resolved catalogue, with trust and phases.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/the-resolved-catalogue-with-trust-and-phases.md)
- [What the skills index holds.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/what-the-skills-index-holds.md)
- [The prompt the next turn would be given, without running one.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/the-prompt-the-next-turn-would-be-given-without-running-one.md)
- [A channel provider's webhook. Open by design; the provider authenticates itself.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/a-channel-providers-webhook-open-by-design-the-provider-authenticates-itself.md)
- [Every event this process emits, as SSE. The firehose.](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/every-event-this-process-emits-as-sse-the-firehose.md)