> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Knowledge Base

> Soft deletes a knowledge base by setting its status to 'DELETED'.

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

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Path Parameters

<ParamField path="knowledge_base_id" type="string" required>
  The unique identifier of the knowledge base to delete.
</ParamField>

### Response

<ResponseField name="data" type="object">
  Deletion confirmation object.

  <ResponseField name="data.success" type="boolean">
    Always `true` when the deletion is successful.
  </ResponseField>

  <ResponseField name="data.message" type="string">
    Confirmation message about the deletion.
  </ResponseField>

  <ResponseField name="data.knowledge_base_id" type="string">
    The ID of the deleted knowledge base.
  </ResponseField>
</ResponseField>

<ResponseField name="errors" type="null">
  Will be `null` on successful deletion.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE https://api.bland.ai/v1/knowledge/kb_01H8X9QK5R2N7P3M6Z8W4Y1V5T \
    -H "authorization: YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "data": {
      "success": true,
      "message": "Knowledge base successfully deleted",
      "knowledge_base_id": "kb_01H8X9QK5R2N7P3M6Z8W4Y1V5T"
    },
    "errors": null
  }
  ```

  ```json Not Found Response theme={null}
  {
    "data": null,
    "errors": [
      {
        "error": "KB_ERROR",
        "message": "KB not found or access denied"
      }
    ]
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)