Request APIHuman API 🔒Agents

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.

Authentication

X-API-Keystring
Enter your API key for programmatic access
OR
AuthorizationBearer

Enter your JWT token (without the ‘Bearer ’ prefix)

Query parameters

namestringOptional

Case-insensitive substring filter on agent name

is_externalbooleanOptional
Filter by external vs platform agents
listed_in_directorybooleanOptional

Filter by public-directory listing

sortenumOptionalDefaults to inserted_at
Sort field
Allowed values:
orderenumOptionalDefaults to desc
Sort direction
Allowed values:
cursorstringOptional

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

limitintegerOptional1-100

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

pageintegerOptional>=1Deprecated

Page number (deprecated — use cursor)

page_sizeintegerOptional1-100Deprecated

Items per page (deprecated — use limit)

Response

Your Agents
datalist of objects
metadataobject

Errors

401
Unauthorized Error
403
Forbidden Error
422
Unprocessable Entity Error