Skip to main content
POST
Create agent

Authorizations

Authorization
string
header
required

Access token from POST /management/v1/auth/token (publishable-key exchange) or a login session. Publishable-key tokens are agent-scoped and serve the messaging surface; login tokens also serve management.

Path Parameters

projectId
string
required
Pattern: ^[0-9a-fA-F]{24}$

Body

application/json

Create an agent. The owning project comes from the URL path.

name
string
required

Agent name

Required string length: 2 - 50

Response

Successful Response

Returns the created agent.

id
string
required

Agent id

Pattern: ^[0-9a-fA-F]{24}$
project_id
string
required

Owning project id

Pattern: ^[0-9a-fA-F]{24}$
name
string
required

Agent name

created_at
string<date-time>
required

Creation timestamp

updated_at
string<date-time>
required

Last update timestamp

live_version_id
string | null

Tag of the currently deployed version; None until deployed