Reference

API reference

Every endpoint, and which need a session.

Every HTTP endpoint of the app, read from its route files. Session means the request needs a signed-in session (the deployment passcode, or the app's own sign-in); Public endpoints answer anyone.

Note

Requests that change data must come from the app's own pages; send JSON unless an endpoint says otherwise.

/api/agent-approvals

Method Path Access What it does
GET /api/agent-approvals Session —

/api/agent-changes

Method Path Access What it does
GET /api/agent-changes/:id Session —
POST /api/agent-changes/:id Session —

/api/agent-channels

Method Path Access What it does
GET /api/agent-channels Session —
POST /api/agent-channels Session —
DELETE /api/agent-channels/:id Session —

/api/agent-posts

Method Path Access What it does
GET /api/agent-posts Session —
PATCH /api/agent-posts/:id Session Actions: approve (pending → scheduled), reject (pending/scheduled → rejected), reschedule (pending/scheduled/failed, with publishAt) and retry (failed → scheduled now).

/api/agent-sites

Method Path Access What it does
GET /api/agent-sites Session —

/api/agents

Method Path Access What it does
GET /api/agents Session —
POST /api/agents Session —
GET /api/agents/:id Session —
PATCH /api/agents/:id Session —
DELETE /api/agents/:id Session —
POST /api/agents/:id/run Session Queues a run; the every-minute cron picks it up (paused agents included, so an agent can be tested before it goes live).

/api/edit-auth

Method Path Access What it does
GET /api/edit-auth Session —
POST /api/edit-auth Session —
DELETE /api/edit-auth Session —

/api/items

Method Path Access What it does
GET /api/items Session —
POST /api/items Session —
PATCH /api/items/:id Session —
DELETE /api/items/:id Session —
GET /api/items/:id/checklist Session —
POST /api/items/:id/checklist Session —
PATCH /api/items/:id/checklist/:checklistId Session —
DELETE /api/items/:id/checklist/:checklistId Session —
GET /api/items/:id/checklist/:checklistId/comments Session —
POST /api/items/:id/checklist/:checklistId/comments Session —
DELETE /api/items/:id/checklist/:checklistId/comments/:commentId Session —
GET /api/items/:id/checklist/:checklistId/documents Session —
POST /api/items/:id/checklist/:checklistId/documents Session —
DELETE /api/items/:id/checklist/:checklistId/documents/:documentId Session —
GET /api/items/:id/checklist/:checklistId/documents/:documentId/file Session —
GET /api/items/:id/checklist/:checklistId/subtasks Session —
POST /api/items/:id/checklist/:checklistId/subtasks Session —
PATCH /api/items/:id/checklist/:checklistId/subtasks/:subtaskId Session —
DELETE /api/items/:id/checklist/:checklistId/subtasks/:subtaskId Session —
GET /api/items/:id/documents Session —
POST /api/items/:id/documents Session —
DELETE /api/items/:id/documents/:docId Session —
GET /api/items/:id/documents/:docId/file Session —

/api/studio

Method Path Access What it does
POST /api/studio/agents Session —
PATCH /api/studio/agents/:id Session Saves the definition locally and publishes a new Managed Agents version.
DELETE /api/studio/agents/:id Session Saves the definition locally and publishes a new Managed Agents version.
GET /api/studio/agents/:id/memory Session —
GET /api/studio/approvals Session —
GET /api/studio/connections Session —
POST /api/studio/connections Session —
DELETE /api/studio/connections/:id Session —
POST /api/studio/files Session —
POST /api/studio/hooks/:id Public —
GET /api/studio/overview Session —
POST /api/studio/runs Session Starts a session for an agent with a task, mounted repos and a budget cap.
GET /api/studio/runs/:id Session —
POST /api/studio/runs/:id Session —
GET /api/studio/runs/:id/files Session —
GET /api/studio/runs/:id/files/:fileId Session —
PATCH /api/studio/settings Session Sandbox networking for new runs, and the default per-run budget.
GET /api/studio/skills Session —
POST /api/studio/skills Session —
PATCH /api/studio/skills/:id Session Saving publishes a new skill version; agents use "latest", so they pick it up on their next run without being re-published.
DELETE /api/studio/skills/:id Session Saving publishes a new skill version; agents use "latest", so they pick it up on their next run without being re-published.
GET /api/studio/tools Session —
POST /api/studio/tools Session —
PATCH /api/studio/tools/:id Session Tool definitions are published on agents, so saving a tool re-publishes every agent that uses it (and their team leads). Leaving the secret value empty keeps the stored one; clearing the header name removes it.
DELETE /api/studio/tools/:id Session Tool definitions are published on agents, so saving a tool re-publishes every agent that uses it (and their team leads). Leaving the secret value empty keeps the stored one; clearing the header name removes it.
POST /api/studio/triggers Session Creates a schedule (an Anthropic scheduled deployment), an inbound webhook (returns its token once), or a chain ("run when another agent finishes").
GET /api/studio/triggers/:id Session —
PATCH /api/studio/triggers/:id Session —
POST /api/studio/triggers/:id Session —
DELETE /api/studio/triggers/:id Session —

Other routes

Method Path Access What it does
GET /health Public Liveness and database check. The System Registry lists https://<host>/health for every catalog.

Pages in the app

Page What it shows
/ —
/agents —
/edit —
/item/:slug —
/item/:slug/workspace —
/studio —
Last updated 2 November 2026