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

Changed in 1 of the 5 revisions of this API.52

  • d4b03725c5d752See the full diff
    • ●

      for the query request parameter limit, the max was set to 100.00

      request-parameter-max-set

    • ●

      for the query request parameter page_size, the max was set to 100.00

      request-parameter-max-set

    • ●

      for the query request parameter limit, the min was set to 1.00

      request-parameter-min-set

    • ●

      for the query request parameter page, the min was set to 1.00

      request-parameter-min-set

    • ●

      for the query request parameter page_size, the min was set to 1.00

      request-parameter-min-set

    • ○

      query request parameter page was deprecated

      request-parameter-deprecated

    • ○

      query request parameter page_size was deprecated

      request-parameter-deprecated