Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

A personal API key or an OAuth 2.0 access token. Personal API keys also require the x-auth-key header with your user ID.

Query Parameters

team_id
string

Scope the listing to a single team. When omitted, returns agents owned by the authenticated user.

Case-insensitive substring match against the agent name.

creator
string

Filter to agents created by this user ID.

has_triggers
boolean

When true, only returns agents that have at least one active trigger configured.

tool
string

Filter to agents that use the specified MCP server as a tool.

flow
string

Filter to agents that use the specified saved flow as a tool.

sort_order
enum<string>
default:newest

Sort order for the listing. Defaults to newest first.

Available options:
newest,
oldest,
name_asc,
name_desc
include_last_used
boolean

When true, populates last_used_at on each agent with the timestamp of its most recent session.

include_last_updated
boolean

When true, populates last_updated_at on each agent with the timestamp of its most recent configuration change.

page_size
integer
default:20

Number of agents per page. Sending page_size or cursor opts into cursor pagination; requests that send neither return the full list.

Required range: 1 <= x <= 100
cursor
string

Opaque cursor from a previous response's next_cursor. Pass it to fetch the next page.

Response

Agents matching the provided filters.

agents
object[]
next_cursor
string | null

Cursor for the next page. Present only on paginated requests; null when there are no more results.

Example:

null