Skip to main content
GET
List agents

Authorizations

X-API-Key
string
header
required

Path Parameters

account_id
string
required

The account ID or 'me' for the current account

Query Parameters

name
string | null

Case-insensitive partial match on agent name.

is_archived
boolean | null

Filter by archived status. If omitted, archived are excluded by default.

include_archived
boolean | null

When true, include archived agents alongside active ones.

created_gt
string<date-time> | null

Filter agents created after this datetime (ISO 8601, timezone-aware).

created_lt
string<date-time> | null

Filter agents created before this datetime (ISO 8601, timezone-aware).

created_ge
string<date-time> | null

Filter agents created on or after this datetime (ISO 8601, timezone-aware).

created_le
string<date-time> | null

Filter agents created on or before this datetime (ISO 8601, timezone-aware).

modified_gt
string<date-time> | null

Filter agents modified after this datetime (ISO 8601, timezone-aware).

modified_lt
string<date-time> | null

Filter agents modified before this datetime (ISO 8601, timezone-aware).

modified_ge
string<date-time> | null

Filter agents modified on or after this datetime (ISO 8601, timezone-aware).

modified_le
string<date-time> | null

Filter agents modified on or before this datetime (ISO 8601, timezone-aware).

tags
string[] | null

Filter by tags. Returns agents that have ALL specified tags.

limit
integer
default:100
Required range: x >= 1
offset
integer
default:0
Required range: x >= 0

Response

OK

count
integer
required
items
AgentResponseSchema · object[]
required