Error
Agents
Create an agent
Creates an agent. The DB auto-creates its v0 draft (do not create it yourself). Returns the agent + the draft. Requires X-Organization-Id and X-User-Id.
POST
Error
Authorizations
Org API key (scopes the request to its organization) or the shared trusted key (requires X-Organization-Id on every request).
Headers
Organization to scope the request to. Optional when authenticating with an org API key (the org is taken from the key; if sent, it must match). Required when authenticating with the trusted key.
End-user identity for the request; user-scoped data (threads, memory) resolves to {orgId}_{userId}. Required by endpoints that read or write user-scoped resources. A userId query param (or body field, where documented) is accepted as a fallback.
Response
Agent created