| GET | /api/v1/livez | Liveness probe — always 200. Wire livenessProbe here. |
| GET | /api/v1/readyz | Readiness probe — 503 once drain begins. Wire readinessProbe and proxy upstream checks here. |
| GET | /api/v1/heartbeat | Ping with the server version; requires a valid credential under any configured scheme (open only under unsecured), so it doubles as a credential check. |
| GET | /api/v1/health | Rich JSON status: runners plus the orphan-pod sweep snapshot; configured runner aliases are admin-only. Not a probe. |
| GET | /api/v1/status | Server status (admin). |
| GET | /api/v1/runners | Configured runners with permits in use, and each external domain's live instances (admin, or read on * with aliases and instance names withheld). |
| GET | /api/v1/runners/queue | Pending runner claims: count, oldest age, breakdown by filter (admin, or read on * with alias filters withheld). |
| GET/POST | /api/v1/agent/{name} | Run an agent. POST is the supported verb; GET is deprecated. |
| GET | /api/v1/agents | List agents, filtered to those you hold a grant on, with inputs, cron state and writable. |
| POST | /api/v1/agents | Create a new agent directory. |
| POST | /api/v1/agents/reload | Rescan the agents directory (admin). |
| GET | /api/v1/agents/{name}/langgraph | Graph topology (nodes and edges) for each LangGraph command. |
| GET | /api/v1/agents/{name}/files | List an agent directory (edit grant). |
| GET/PUT/DELETE | /api/v1/agents/{name}/files/… | Read, write and delete files in an agent directory; writes are schema-validated. |
| POST | /api/v1/agents/{name}/debug | Run one command of an agent with ad-hoc env and params. |
| POST | /api/v1/agents/{name}/cron-run | Fire any agent immediately with cron semantics, with or without a cron block — no parameters, owned by the scheduler (admin; a denial is the same 404 as an unknown agent, and a preflight refusal starts nothing and still answers 204). |
| GET | /api/v1/schemas/agent | The agent JSON Schema (used by the console editor). |
| GET | /api/v1/status/{id} | One process: history, executions, inputs, cost, cost source, runner state, open questions, Langfuse trace link, parent run id. |
| GET | /api/v1/status/all | Process list with types, agentName, parentProcessId (children of one run), rootProcessId (every run below the flow root; a root the caller cannot see reads as an empty list) and roots=true (one row per flow), tag (repeatable, ANDed subject-tag filter; at most 10, matches bounded at 10 000 rows), order, limit (default 100, max 1000), offset. |
| DELETE | /api/v1/kill/{id} | Kill a running process. |
| POST | /api/v1/processes/{id}/retry | Replay a FINISHED/FAILED/KILLED run with re-validated inputs (inputs removed since are dropped). |
| GET | /api/v1/processes/{id}/langgraph | LangGraph run status: thread id, per-node state, fan-out subs, traversed edges. |
| POST | /api/v1/processes/{id}/resume | Resume a failed LangGraph run from its checkpoint. |
| GET | /api/v1/artifacts | Stream one artifact file; carries X-Process-Status and X-File-Complete. |
| GET | /api/v1/artifacts/list | List a run's artifacts (capped, with a truncated flag). |
| GET | /api/v1/questions | Questions by status or process, paged, with dispatch annotations. |
| POST | /api/v1/questions/{id}/answer | Answer an open question and fire any bound dispatch. |
| GET/DELETE | /api/v1/dispatches[/{id}] | List newest first (status, agentName, limit default 100 and max 1000, offset; the reply carries total), inspect and cancel ask-and-dispatch records; secret parameter values come back masked. |
| GET/DELETE | /api/v1/continuations[/{id}] | List newest first (status, agentName, limit default 100 and max 1000, offset; the reply carries total), inspect and cancel completion continuations; secret parameter values come back masked. |
| GET | /api/v1/costs | Rolling LLM harness (Claude/Codex/opencode) spend windows plus configured caps (admin). |
| GET | /api/v1/costs/monthly | Per-agent spend for one UTC month from the persistent ledger (admin). |
| GET | /api/v1/costs/totals | All-time per-agent spend (admin). |
| GET | /api/v1/costs/by-tag/{key} | Spend per value of one configured subject-tag key; key must be in costTrackedTagKeys; secret and removed-key values are excluded (fail-closed); truncated flags a total summed from fewer than all matching runs (admin). |
| GET | /api/v1/stream/processes | SSE: status and command transitions plus question events. |
| GET | /api/v1/stream/processes/{id}/llm-events | SSE: canonical LLM events of a run, live or finished, resumable. |
| GET | /api/v1/stream/processes/{id}/logs | SSE: live stdout/stderr tail, resumable via Last-Event-ID. |
| GET | /api/v1/stream/agents | SSE: agent reload diffs (added / updated / removed). |
| POST | /api/v1/callback/questions | Workspace callback: ask a question (per-process token). |
| GET | /api/v1/callback/questions/{id} | Workspace callback: read or long-poll the answer (waitSec). |
| POST | /api/v1/callback/dispatches | Workspace callback: register an ask-and-dispatch. |
| POST | /api/v1/callback/runs | Workspace callback: dispatch now, optionally with a continuation. |
| POST | /api/v1/callback/joins | Workspace callback: parallel fan-out with one join continuation. |
| POST | /api/v1/callback/tags | Workspace callback: declare a runtime subject tag on the run (homer-tag). |
| GET | /api/v1/callback/results/{token} | Fetch an oversized result behind a capability token. |
| GET | /api/v1/callback/whoami | Workspace callback: which run and agent hold a callback token, for an egress proxy deciding per agent (any method; one 401 otherwise). |
| POST | /api/v1/runner/register | Runner protocol: register a pull-mode runner instance in the domain the token belongs to (201; 422 bad tags/concurrency, a name or a non-blank version outside the tag shape, or a name already held by a live instance of the domain; 429 at maxInstances). Runner domain token (runners.*.token); 401 for every apiAuth credential. |
| DELETE | /api/v1/runner/instances/{id} | Runner protocol: deregister an instance (204; 404 unknown or foreign id). |
| POST | /api/v1/runner/instances/{id}/claim | Runner protocol: long-poll for a run to execute (200 session, 204 nothing or instance draining, 404 unknown or foreign instance id, 429 too many polls). |
| POST | /api/v1/runner/sessions/{sid}/next | Runner protocol: report the previous op's result and long-poll for the next op (200 op, 204 nothing, 400 malformed body, 404 unknown session, 429 more than 3 polls open on the session — the reported result is still recorded). |
| GET | /api/v1/runner/sessions/{sid}/ops/{opId}/tar | Runner protocol: fetch the gzip'd tar of an upload op (200 stream; 404 unknown or finished op; past transferTimeoutSec the stream is cut off, its 200 already sent; 429 another fetch of the op in flight). |
| POST | /api/v1/runner/sessions/{sid}/ops/{opId}/tar | Runner protocol: post the gzip'd tar of a download op (?kind=dir|file; 202; 400 bad kind; 404 unknown or finished op; 408 past transferTimeoutSec; 413 over maxTransferBytes compressed or decompressed; 422 a refused entry (escaping, or a mode that cannot be normalized); 429 another post of the op in flight). |
| POST | /api/v1/runner/sessions/{sid}/ops/{opId}/output | Runner protocol: append one output chunk (?stream=stdout|stderr&seq=N; 202; 400 bad stream or seq; 404 unknown or finished op; 408 past transferTimeoutSec; 409 out of order; 413 over 1 MiB; 429 another chunk of the op and stream in flight). |
| POST | /api/v1/auth/login | Exchange username + password for a session cookie. |
| POST | /api/v1/auth/logout | Clear the session cookie (idempotent). |
| GET | /api/v1/auth/me | Your username, role and grants — the console's capability source. The auth/* routes exist only with a !<password> scheme. |
| POST | /mcp | MCP endpoint exposing opted-in agents as tools (both MCP routes only with server.mcp.enabled). |
| POST | /mcp/questions | MCP question tools for a running command. |