curl -X GET 'https://api.elevenlabs.io/v1/convai/tools?search=example-search&page_size=10&show_only_owned_documents=false&created_by_user_id=created-by-user-id&types=example&sort_direction=asc&sort_by=name&used_by_agent_id=used-by-agent-id&cursor=example-cursor' \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

# GET /v1/convai/tools (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-10-20

> Get Tools

## Critical Gotchas
* Authentication uses the non-standard `xi-api-key` header, not `Authorization: Bearer`. Sending a Bearer token returns HTTP 401.
* Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (`--output speech.mp3`) rather than parsing it.

## cURL
curl -X GET 'https://api.elevenlabs.io/v1/convai/tools?search=example-search&page_size=10&show_only_owned_documents=false&created_by_user_id=created-by-user-id&types=example&sort_direction=asc&sort_by=name&used_by_agent_id=used-by-agent-id&cursor=example-cursor' \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| search | query | string | No | If specified, the endpoint returns on... |
| page_size | query | integer | No | How many documents to return at maxim... |
| show_only_owned_documents | query | boolean | No | If set to true, the endpoint will ret... |
Other params: created_by_user_id, types, sort_direction, sort_by, used_by_agent_id, cursor

## Response (200 OK)
{"tools":[{}],"next_cursor":"string"}

---
Need an API key? Get one at https://elevenlabs.io/app/sign-up

GET

GET /v1/convai/tools — ElevenLabs API

ElevenLabs API

Get Tools

Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 215 tokens · Vary: Accept

Critical gotchas

Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.

Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.

cURL

curl -X GET 'https://api.elevenlabs.io/v1/convai/tools?search=example-search&page_size=10&show_only_owned_documents=false&created_by_user_id=created-by-user-id&types=example&sort_direction=asc&sort_by=name&used_by_agent_id=used-by-agent-id&cursor=example-cursor' \  -H "xi-api-key: $ELEVENLABS_API_KEY"

Parameters

Name	In	Type	Required	Description
search	query	string	No	If specified, the endpoint returns only tools whose names start with this string.
page_size	query	integer	No	How many documents to return at maximum. Can not exceed 100, defaults to 30.
show_only_owned_documents	query	boolean	No	If set to true, the endpoint will return only tools owned by you (and not shared from somebody else). Deprecated: use created_by_user_id instead.
created_by_user_id	query	string	No	Filter tools by creator user ID. When set, only tools created by this user are returned. Takes precedence over show_only_owned_documents. Use '@me' to refer to the authenticated user.
types	query	string[]	No	If present, the endpoint will return only tools of the given types.
sort_direction	query	string	No	The direction to sort the results
sort_by	query	string	No	The field to sort the results by
used_by_agent_id	query	string	No	Filter to tools referenced by this agent's main branch: tools attached to the agent, tools on authored workflow nodes, and tools referenced by procedures.
cursor	query	string	No	Used for fetching next page. Cursor is returned in the response.

Response 200 OK

{
  "tools": [
    {
      "id": "string",
      "tool_config": {
        "response_timeout_secs": 20,
        "type": "webhook"
      },
      "access_info": {
        "access_source": "creator",
        "creator_email": "[email protected]",
        "creator_name": "John Doe",
        "is_creator": true,
        "role": "admin"
      },
      "usage_stats": {
        "total_calls": 0,
        "avg_latency_secs": 0
      },
      "response_mocks": [
        {
          "parameter_conditions": [
            "[recursive or deeply nested schema]"
          ],
          "mock_result": "string",
          "is_error": false
        }
      ]
    }
  ],
  "next_cursor": "string",
  "has_more": true
}

Get a free ElevenLabs API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.