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

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

> Delete 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 DELETE 'https://api.elevenlabs.io/v1/convai/tools/tool-id?force=false' \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| tool_id | path | string | Yes | ID of the requested tool. |
| force | query | boolean | No | If set to true, the tool will be deleted regardless of wh... |

## Response (200 OK)
{}

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

DELETE

DELETE /v1/convai/tools/{tool_id} — ElevenLabs API

ElevenLabs API

Delete Tool

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
→ 186 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 DELETE 'https://api.elevenlabs.io/v1/convai/tools/tool-id?force=false' \  -H "xi-api-key: $ELEVENLABS_API_KEY"

Parameters

Name	In	Type	Required	Description
tool_id	path	string	Yes	ID of the requested tool.
force	query	boolean	No	If set to true, the tool will be deleted regardless of whether it is used by any agents and it will be removed from the dependent agents and branches.

Response 200 OK

{}

Get a free ElevenLabs API key → sponsored

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