Delete knowledge base

Permanently delete a knowledge base with its sources and chunks.

DELETEhttps://api.tried.com.au/delete-knowledge-base/{id}

Deletes a knowledge base. Its sources and stored chunks are deleted with it. Remove the ID from any agent's knowledge_base_ids first, or the agent will search a knowledge base that no longer exists.

Request#

Path parameter	Type	Required	Description
`id`	string	Yes	The knowledge base ID, starting with `knowledge_base_`.

Example request#

curl -X DELETE https://api.tried.com.au/delete-knowledge-base/knowledge_base_9f060d81a4d8df9b04ca6d12 \
  -H "Authorization: Bearer $TRIED_API_KEY"

await fetch(
  "https://api.tried.com.au/delete-knowledge-base/knowledge_base_9f060d81a4d8df9b04ca6d12",
  {
    method: "DELETE",
    headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
  },
);

import os, requests

requests.delete(
    "https://api.tried.com.au/delete-knowledge-base/knowledge_base_9f060d81a4d8df9b04ca6d12",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
)

Response#

204 No Content

The response has no body.

Errors#

Status	When
`401`	Missing or invalid API key.
`403`	The key's IP allowlist or scopes reject the request (this route needs the `kb` scope), or the caller is a read-only dashboard member.
`404`	`Knowledge base <id> not found`.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.

Retell compatibility#

Same path, method and 204 response as Retell. A missing knowledge base returns 404 (Retell uses 422).