Skip to main content
GET
List agents

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

Query Parameters

filters
AgentListFilters · object
required

Query filters for listing agents in a project.

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
Agent · object[]
required
meta
PageMeta · object
required