Skip to main content
DELETE
Delete a knowledge document
Permanently deletes a document from an agent’s knowledge base. This action cannot be undone.

Overview

Deletion removes the document record, the stored file and the copy held by the voice provider. There is no soft-delete and no version history to recover from, which is what makes this a genuine erasure rather than a hidden retention. The freed slot is available immediately.

Example

This is the response shape after the August 3, 2026 envelope change. Until that cutover, integrations still receiving the legacy envelope get { "statusCode": 200, "message": "Success", "data": true, "traceId": "…" } instead. Watch for the Deprecation and Sunset headers to tell which shape you are on.

Pending Documents

Works on PENDING documents too. Deleting one is how you release a reserved slot straight away instead of waiting for the 24-hour cleanup.
To stop using a document without losing it, deactivate it instead.

Error Scenarios

  • 404 Not Found: No such document on that agent

Authorizations

Authorization
string
header
required

API key for authentication using Bearer scheme

Path Parameters

id
string<uuid>
required

Agent the knowledge base belongs to.

documentId
string<uuid>
required

Knowledge document id.

Query Parameters

companyId
string

Required for ATS API keys to specify which company to access. Ignored for standard company API keys.

Response

Deleted successfully

id
string<uuid>
required

Id of the deleted resource

deleted
enum<boolean>
required

Always true; a failed delete answers with an error status

Available options:
true
Example:

true