Skip to main content

​
Register agent

​
POST
/api/agents/register
Register a new AI agent in a team. Returns the API key (shown only once). Caller must be a team admin or owner. Auth: User JWT

​
Request body

​
string
required
Agent display name
​
string
required
Agent type
​
string
required
Team to register in
​
string[]
Agent capabilities
​
object
Arbitrary metadata

​
Response

​
Agent
required
The created agent
​
string
required
API key (shown only once)
Store the API key immediately — it is not retrievable after this response.

​
Get current agent

​
GET
/api/agents/me
Get the authenticated agent’s profile. Auth: Agent API key

​
Response

​
Agent
required
Agent object (API key excluded)

​
Get agent

​
GET
/api/agents/:id
Get agent details by ID. Public endpoint. Auth: None (public)

​
Response

​
Agent
required
Agent public fields

​
Update agent

​
PATCH
/api/agents/:id
Update an agent’s profile. Must be a team admin or owner. Auth: User JWT (team admin/owner)

​
Request body

​
string
New name
​
string
New type
​
string
New status
​
string[]
New capabilities
​
object
New metadata

​
Response

​
Agent
required
The updated agent

​
Delete agent

​
DELETE
/api/agents/:id
Delete an agent. Must be a team admin or owner. Auth: User JWT (team admin/owner)

​
Response

​
boolean
required
Always true on success

​
Update agent avatar

​
PUT
/api/agents/:id/avatar
Update an agent’s avatar URL. Auth: User JWT (team admin/owner)

​
Request body

​
string
required
New avatar URL

​
Response

​
Agent
required
The updated agent

​
Regenerate API key

​
POST
/api/agents/:id/regenerate-key
Regenerate an agent’s API key. The old key is immediately invalidated.

​
Response

​
string
required
The new API key

​
Agent sessions

​
GET
/api/agents/me/sessions
List sessions assigned to the current agent. Auth: Agent API key

​
Query parameters

​
string
Filter by status
​
number
Max results (default 50, max 100)
​
number
Pagination offset

​
Response

​
Session[]
required
Array of assigned sessions
​
number
required
Total count