curl -X POST 'https://api.elevenlabs.io/v1/convai/knowledge-base/bulk-delete' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "document_ids": [
    "string"
  ],
  "force": false
}'

# POST /v1/convai/knowledge-base/bulk-delete (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03

> Bulk Delete Knowledge Base Documents

## 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 POST 'https://api.elevenlabs.io/v1/convai/knowledge-base/bulk-delete' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"document_ids":["string"],"force":false}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| document_ids | body | string[] | Yes | The ids of documents or folders from the knowledge base. |
| force | body | boolean | No | If set to true, documents or folders will be deleted rega... |

## Response (200 OK)
{}

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

POST

/v1/convai/knowledge-base/bulk-delete

ElevenLabs API

Bulk Delete Knowledge Base Documents

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
→ 205 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 POST 'https://api.elevenlabs.io/v1/convai/knowledge-base/bulk-delete' \  -H "xi-api-key: $ELEVENLABS_API_KEY" \  -H 'Content-Type: application/json' \  -d '{  "document_ids": [    "string"  ],  "force": false}'

Get a free ElevenLabs API key → sponsored

Parameters

Name	In	Type	Required	Description
document_ids	body	string[]	Yes	The ids of documents or folders from the knowledge base.
force	body	boolean	No	If set to true, documents or folders will be deleted regardless of whether they are used by any agents and will be removed from the dependent agents. For non-empty folders, this will also delete all child documents and folders.

Response 200 OK

{}