List agents | ElevenLabs Documentation

from elevenlabs import ElevenLabs
client = ElevenLabs()
client.conversational_ai.agents.list(
    page_size=1,
    search="search",
    archived=True,
    show_only_owned_agents=True,
    created_by_user_id="created_by_user_id",
    sort_direction="asc",
    sort_by="name",
    cursor="cursor",
)

{
  "agents": [
    {
      "agent_id": "J3Pbu5gP6NNKBscdCdwB",
      "name": "My Agent",
      "tags": [
        "Customer Support",
        "Technical Help",
        "Eleven"
      ],
      "created_at_unix_secs": 1716153600,
      "access_info": {
        "is_creator": true,
        "creator_name": "John Doe",
        "creator_email": "john@example.com",
        "role": "admin"
      },
      "last_call_time_unix_secs": 1,
      "archived": false
    }
  ],
  "has_more": false,
  "next_cursor": "123"
}

Returns a list of your agents and their metadata.

Query parameters

page_sizeintegerOptional1-100Defaults to 30

How many Agents to return at maximum. Can not exceed 100, defaults to 30.

searchstringOptional

Search by agents name.

archivedbooleanOptional

Filter agents by archived status

show_only_owned_agentsbooleanOptionalDefaults to falseDeprecated

If set to true, the endpoint will omit any agents that were shared with you by someone else and include only the ones you own. Deprecated: use created_by_user_id instead.

created_by_user_idstringOptional

Filter agents by creator user ID. When set, only agents created by this user are returned. Takes precedence over show_only_owned_agents. Use ‘@me’ to refer to the authenticated user.

sort_directionenumOptional

The direction to sort the results

Allowed values:

sort_byenumOptional

The field to sort the results by

Allowed values:

cursorstringOptional

Used for fetching next page. Cursor is returned in the response.

Response

Successful Response

agentslist of objects

A list of agents and their metadata

has_moreboolean

Whether there are more agents to paginate through

next_cursorstring

The next cursor to paginate through the agents

Errors

422

Agents List Request Unprocessable Entity Error

Headers

Query parameters

Response

Errors