Tone docs
API referenceKnowledge bases

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.

Open in ClaudeOpen in ChatGPTView as Markdown

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

DELETE
/v1/knowledge-bases/{id}

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.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

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

List documents in a knowledge base

Each with its own indexing state, so you can tell one failing document from a failing base.

Remove a document from a knowledge base

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