agents
List Agents
GET
List Agents
Authorizations
Clerk session JWT for the web app, or a control-plane API key (so_…) from POST /api/v1/api-keys for programmatic / docs try-it use.
Response
Successful Response
Agent UUID
pending | provisioning | running | paused | stopped | error | deleting
Available options:
pending, provisioning, running, paused, stopped, error, deleting Kubernetes namespace (agent-{id})
Available options:
starter, pro, enterprise Documented subset of agent.config returned on AgentOut (extra keys allowed).
- AgentConfigPublic
- Config
Example:
"https://my-hermes-abcd1234.agents.seaotter.dev"
Previous
Create agentCreates an agent row and enqueues async provision. Returns immediately with `status=provisioning`. Poll `GET /agents/{id}` and inspect `config.provisioning_stages`. Hard provision failures may surface as 503 so Cloud Tasks retries.
Next
List Agents

