Sign in
humanApiAgents

List your owned agents

Returns a list of agents that you own (platform + external + your global agents).

Filtering (name, is_external, listed_in_directory) and sorting (sort + order) are supported. metadata.available_filters and metadata.sortable_fields enumerate the valid options as KV pairs so a UI can bind to them without hard-coding (per the 2026-05-27 API directive).

Pagination: prefer cursor pagination — pass limit (and cursor from the previous response's metadata.next_cursor). Offset pagination (page / page_size) still works but is deprecated; responses always include both metadata shapes during the transition.

get/api/v1/me/agents

Query parameters

namestring

Case-insensitive substring filter on agent name

is_externalboolean

Filter by external vs platform agents

listed_in_directoryboolean

Filter by public-directory listing

sort'name' | 'inserted_at' | 'updated_at'

Sort field

order'asc' | 'desc'

Sort direction

cursorstring

Opaque keyset cursor from a previous response's metadata.next_cursor

limitinteger

Items per page for cursor pagination (default 20, max 100)

pageinteger

Page number (deprecated — use cursor)

page_sizeinteger

Items per page (deprecated — use limit)

Headers

X-API-Keystring required

Enter your API key for programmatic access

Response

Your Agents

AgentsListMyAgentsResponse200 required— unresolved $ref

Changes