curl -X GET 'https://api.elevenlabs.io/v1/convai/tools/tool-id?environment=production' \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

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

> Get Tool

## 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/tool-id?environment=production' \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| tool_id | path | string | Yes | ID of the requested tool. |
| environment | query | string | No | Environment whose values are used when the MCP server URL... |

## Response (200 OK)
{"id":"string","tool_config":{"response_timeout_secs":20,"type":"webhook"}}

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

GET

/v1/convai/tools/{tool_id}

ElevenLabs API

Get Tool

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

Actions

Agents: curl -H "Accept: text/markdown" this URL
→ 184 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/tool-id?environment=production' \  -H "xi-api-key: $ELEVENLABS_API_KEY"

Get a free ElevenLabs API key → sponsored

Parameters

Name	In	Type	Required	Description
tool_id	path	string	Yes	ID of the requested tool.
environment	query	string	No	Environment whose values are used when the MCP server URL, headers, or auth connection reference environment variables. Mirrors the environment a conversation would run in; defaults to production.

Response 200 OK

{
  "id": "string",
  "tool_config": {
    "response_timeout_secs": 20,
    "type": "webhook"
  },
  "access_info": {
    "access_source": "creator",
    "creator_email": "john.doe@example.com",
    "creator_name": "John Doe",
    "is_creator": true,
    "role": "admin"
  },
  "usage_stats": {
    "total_calls": 0,
    "avg_latency_secs": 0
  },
  "response_mocks": [
    {
      "parameter_conditions": [
        {
          "eval": {
            "type": "[recursive or deeply nested schema]",
            "description": "[recursive or deeply nested schema]"
          },
          "path": "string"
        }
      ],
      "mock_result": "string",
      "is_error": false
    }
  ]
}