Skip to main content
DELETE
/
api
/
knowledge-bases
/
delete-knowledge-base
/
{knowledgeBaseId}
curl -X DELETE "https://api.zudu.ai/api/knowledge-bases/delete-knowledge-base/kb_abc123def456" \
  -H "X-API-KEY: sk_Abc123Def456..." \
  -H "X-API-SECRET: s3cr3t_Xyz789..." \

{
  "message": "Knowledge base deleted successfully",
  "status": "success",
  "error": null,
  "data": {
    "knowledge_base_id": "kb_abc123def456",
    "organization_id": "org_1234567890",
    "deleted": true
  }
Permanently delete a knowledge base and all its associated sources. This will also delete all files from Azure Blob Storage. 
curl -X DELETE "https://api.zudu.ai/api/knowledge-bases/delete-knowledge-base/kb_abc123def456" \
  -H "X-API-KEY: sk_Abc123Def456..." \
  -H "X-API-SECRET: s3cr3t_Xyz789..." \

{
  "message": "Knowledge base deleted successfully",
  "status": "success",
  "error": null,
  "data": {
    "knowledge_base_id": "kb_abc123def456",
    "organization_id": "org_1234567890",
    "deleted": true
  }

​
Headers

​
X-API-KEY
string
required
Your API key (format: sk_...)
​
X-API-SECRET
string
required
Your API secret (format: s3cr3t_...)

​
Path Parameters

​
knowledgeBaseId
string
required
The knowledge base ID to delete (format: kb_...)Example: kb_abc123def456

​
Response Fields

​
knowledge_base_id
string
The ID of the deleted knowledge base
​
organization_id
string
Organization ID the knowledge base belonged to
​
deleted
boolean
Confirmation that deletion was successfulAlways true on successful deletion.

​
Error Responses

​
error
string
Not Found - Knowledge base does not exist
{
  "message": "Knowledge base not found",
  "status": "error",
  "error": "Knowledge base 'kb_abc123' does not exist in organization 'org_1234567890'"
}
​
error
string
Unauthorized - Missing or invalid API key/secret
​
error
string
Internal Server Error - Failed to delete knowledge base
{
  "message": "Failed to delete knowledge base",
  "status": "error",
  "error": "Storage service unavailable"
}

​
Notes

  • Warning: This operation is permanent and cannot be undone
  • All associated sources will be deleted
  • All files stored in Azure Blob Storage will be permanently removed
  • The knowledge base must belong to your organization (automatically enforced)
  • Deletion is immediate and cannot be reversed
  • Consider backing up important knowledge bases before deletion
  • Agents using this knowledge base will need to be updated to remove the reference