Agents Platform

List Agents

Changed on

Returns a list of your agents and their metadata.

get/v1/convai/agents

Request

  • Base URL
    https://api.elevenlabs.io (the document declares no server; this is the origin it was published from)
  • URL
    https://api.elevenlabs.io/v1/convai/agents
  • Auth
    none declared

Query parameters

page_sizeinteger

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

searchstring nullable

Search by agents name.

archivedboolean nullable

Filter agents by archived status

show_only_owned_agentsboolean

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_idstring nullable

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.

tagsstring[] nullable

Filter agents by tag. Repeat the parameter to match any of several tags.

[
  "Customer Support"
]
sort_direction'asc' | 'desc'

The direction to sort the results

sort_by'name' | 'created_at' | 'updated_at' | 'call_count_7d'

The field to sort the results by

cursorstring nullable

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

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Response

Successful Response

next_cursorstring nullable

The next cursor to paginate through the agents

has_moreboolean required

Whether there are more agents to paginate through

Example response

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

Changes

  • 6bdc01ad54abRevision changes
    • info

      added the enum value updated_at to the property anyOf[subschema #1: AgentSortBy]/ of the query request parameter sort_by

    • info

      added the required property // to the response with the status

  • d393c67c384aRevision changes
    • info

      added the required property // to the response with the status