List agents

from elevenlabs import ElevenLabs
from elevenlabs.environment import ElevenLabsEnvironment
client = ElevenLabs(
    environment=ElevenLabsEnvironment.PRODUCTION
)
client.conversational_ai.agents.list(
    page_size=1,
    search="search",
    archived=True,
    show_only_owned_agents=True,
    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 false

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

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 or null

The next cursor to paginate through the agents

Headers

Query parameters

Response

Errors