Skip to main content
GET
List Agents

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Project-ID
string | null

Query Parameters

page
integer
default:1

Page number (starts at 1)

Required range: x >= 1
limit
integer
default:20

Items per page

Required range: 1 <= x <= 100
status
string | null

Filter by admin status

lifecycle_stage
string | null

Filter by lifecycle stage

tags
string | null

Filter by tags (comma-separated)

a2a_protocol_version
string | null

Filter by A2A protocol version

sort
string | null

Sort: field:order,...

created_by
string | null

Filter by creator (e.g., 'user:alice')

owner_id
string | null
deprecated

Deprecated: use created_by instead. Will be removed in a future release.

Response

Successful Response

Paginated list response.

data
AgentSummary · object[]
required
pagination
Pagination · object
required

Pagination metadata for list responses.