Tone docs
API referenceKnowledge bases

Remove a document from a knowledge base

The index is rebuilt without it. Until that build succeeds, the old index keeps serving.

Open in ClaudeOpen in ChatGPTView as Markdown

Requires the write scope. A key with less gets 403 insufficient_scope.

DELETE
/v1/knowledge-bases/{id}/documents/{documentId}

Authorization

AuthorizationBearer <token>

Authorization: Bearer tone_live_… or tone_test_…. The prefix IS the environment: a test key reaches only the sandbox, and no request field bridges the two.

In: header

Path Parameters

id*string

The knowledge base's id.

documentId*string

The document's id.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/knowledge-bases/string/documents/string"
{  "data": null}
Was this page helpful?

Delete a knowledge base and everything in it

Documents and the built index go with it. Agents attached to it simply stop having it — they keep working.

Preview what an agent would retrieve, and answer, for a question

Runs the SAME retrieval a live turn runs, so what you see here is what the agent would get. Optionally generates the answer a caller would hear. degraded: true means embeddings were unavailable and this fell back to keyword search alone — the results are real, just weaker.