Skip to main content
GET
List agents

Authorizations

Authorization
string
header
required

OAuth2 Authorization Code flow

Query Parameters

expand
string

Comma-separated fields to expand. Supports selection with brackets (e.g., "createdBy,updatedBy" or "targets.company[icon,tradeName]").

Example:

"createdBy"

page_size
number
default:20

Number of results per page (Notion-style cursor pagination, max 100)

Required range: 1 <= x <= 100
Example:

100

start_cursor
string

Opaque cursor for pagination. Use the next_cursor from previous response.

Example:

"eyJjcmVhdGVkX3RpbWUiOiIyMDI0LTExLTE1VDEwOjAwOjAwLjAwMFoiLCJpZCI6InBhZ2VfYWJjMTIzIn0="

filter
string

Stripe-like filter (e.g., target_type:"company" AND name:"report")

Example:

"target_type:\"company\""

include_archived
boolean

Include archived agents in the results

has_steps
boolean

Filter by has_steps

sort
string

Sort field and direction. Format: "field:direction". Allowed fields: created_at, name. Directions: asc, desc.

Response

List of agents

object
string
required
Example:

"list"

results
object[]
required
has_more
boolean
required
next_cursor
string | null
type
string