---
title: "Bulk Delete Knowledge Base Documents"
method: POST
path: "/v1/convai/knowledge-base/bulk-delete"
tags: ["Agents Platform"]
---

# Bulk Delete Knowledge Base Documents

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

Delete multiple documents or folders from the knowledge base. Each id succeeds or fails independently.

## Headers

- `xi-api-key` string, 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.

## Request body

- BodyBulkDeleteKnowledgeBaseDocumentsV1ConvaiKnowledgeBaseBulkDeletePost
  - `document_ids` string[], required — The ids of documents or folders from the knowledge base.
  - `force` boolean — 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`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/versions/57d56f34628a/schema)