Create an agent
Creates a new agent in the current project. The identifier must be lowercase alphanumeric with hyphens, starting with a letter or number (max 50 chars).
A new agent starts with no grants: the gateway injects no credentials for it until you attach a connection or secret (see the Grants endpoints).
The response does not include the agent’s access token — read it from GET /agents or regenerate it with POST /agents/{agentId}/regenerate-token.
Authorizations
API key obtained from the dashboard or GET /user/api-key
Body
Display name for the agent
1 - 255"Claude Assistant"
Unique identifier (lowercase, alphanumeric, hyphens)
^[a-z0-9][a-z0-9-]{0,49}$"claude-assistant"
Accepted for compatibility but has no effect — credential inheritance was removed. Every new agent starts with no grants regardless of this field.
^[a-z0-9][a-z0-9-]{0,49}$"orchestrator"