Skip to main content
POST
Create an agent

Authorizations

Authorization
string
header
required

API key obtained from the dashboard or GET /user/api-key

Body

application/json
name
string
required

Display name for the agent

Required string length: 1 - 255
Example:

"Claude Assistant"

identifier
string
required

Unique identifier (lowercase, alphanumeric, hyphens)

Pattern: ^[a-z0-9][a-z0-9-]{0,49}$
Example:

"claude-assistant"

parentIdentifier
string

Accepted for compatibility but has no effect — credential inheritance was removed. Every new agent starts with no grants regardless of this field.

Pattern: ^[a-z0-9][a-z0-9-]{0,49}$
Example:

"orchestrator"

Response

Agent created

id
string
name
string
identifier
string
createdAt
string<date-time>