Skip to main content
GET
Get an 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

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

Response

Successful Response

The published Agent shape.

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

runtime_version
string | null

Runtime build the live version's bundle targets, e.g. '0.8.0'. None when nothing is deployed or the bundle pins no runtime

schema_version
string | null

AUI schema version of the live version's bundle. None until deployed