Create agent
Creates 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.
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.
Body
Display name for the agent
1 - 120"my-hermes"
Plan tier: starter | pro | enterprise (CPU/memory/storage from PLAN_QUOTAS)
starter, pro, enterprise "starter"
User-supplied env (filtered; dashboard auth keys rejected)
Optional seed config; provisioning_stages are filled by the control plane
Response
Successful Response
Agent UUID
pending | provisioning | running | paused | stopped | error | deleting
pending, provisioning, running, paused, stopped, error, deleting Kubernetes namespace (agent-{id})
starter, pro, enterprise Documented subset of agent.config returned on AgentOut (extra keys allowed).
- AgentConfigPublic
- Config
"https://my-hermes-abcd1234.agents.seaotter.dev"

