Skip to main content
DELETE
/
v1
/
knowledge
/
{knowledge_base_id}
curl -X DELETE https://api.bland.ai/v1/knowledge/kb_01H8X9QK5R2N7P3M6Z8W4Y1V5T \
  -H "authorization: YOUR_API_KEY"

{
  "data": {
    "success": true,
    "message": "Knowledge base successfully deleted",
    "knowledge_base_id": "kb_01H8X9QK5R2N7P3M6Z8W4Y1V5T"
  },
  "errors": null
}
Marks a knowledge base as deleted by setting its status to "DELETED". This is a soft delete operation - the knowledge base data is retained but becomes inaccessible for normal operations.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Path Parameters

​
knowledge_base_id
string
required
The unique identifier of the knowledge base to delete.

​
Response

​
data
object
Deletion confirmation object.
​
data.success
boolean
Always true when the deletion is successful.
​
data.message
string
Confirmation message about the deletion.
​
data.knowledge_base_id
string
The ID of the deleted knowledge base.
​
errors
null
Will be null on successful deletion.
curl -X DELETE https://api.bland.ai/v1/knowledge/kb_01H8X9QK5R2N7P3M6Z8W4Y1V5T \
  -H "authorization: YOUR_API_KEY"

{
  "data": {
    "success": true,
    "message": "Knowledge base successfully deleted",
    "knowledge_base_id": "kb_01H8X9QK5R2N7P3M6Z8W4Y1V5T"
  },
  "errors": null
}