Delete a knowledge document
Agent Knowledge Base
Delete Knowledge Document
Permanently deletes the document, the stored file and the copy held by the voice provider. This cannot be undone.
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 onPENDING 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
Related Resources
Authorizations
API key for authentication using Bearer scheme
Path Parameters
Agent the knowledge base belongs to.
Knowledge document id.
Query Parameters
Required for ATS API keys to specify which company to access. Ignored for standard company API keys.