Skip to main content
GET
List versions

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}$

Query Parameters

status
enum<string>[] | null
Available options:
draft,
published,
archived
tag
string | null

Filter by tag (partial match)

version_number
integer | null

Filter by version number (exact match)

label
string | null

Filter by label (partial match)

exclude_revisions
boolean | null

If true, only return base versions (revision 0)

page[size]
integer
default:50
Required range: 1 <= x <= 100
page[after]
string | null
page[before]
string | null
sort_by
string
default:created_at
sort_order
enum<string>
default:desc
Available options:
asc,
desc

Response

Successful Response

results
AgentVersion · object[]
required
meta
PageMeta · object
required