List your owned agents

{
  "data": [
    {
      "id": "string",
      "inserted_at": "2024-01-15T09:30:00Z",
      "is_external": true,
      "name": "string",
      "updated_at": "2024-01-15T09:30:00Z",
      "avatar_url": "string",
      "description": "string",
      "listed_in_directory": true,
      "model_type": "string",
      "registry_access": true,
      "shared_with_organization": true,
      "slug": "string",
      "system_prompt_id": "string",
      "tags": [
        "string"
      ]
    }
  ],
  "metadata": {
    "available_filters": [
      {
        "label": "string",
        "param": "string",
        "type": "string"
      }
    ],
    "has_more": true,
    "limit": 1,
    "next_cursor": "string",
    "sortable_fields": [
      {
        "label": "string",
        "param": "string"
      }
    ],
    "page": 1,
    "page_size": 1,
    "total_count": 1,
    "total_pages": 1
  }
}

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

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