Skip to main content
DELETE
/
v1
/
knowledge
/
{kb_id}
Delete Knowledge Base
curl --request DELETE \
  --url https://api.xpander.ai/v1/knowledge/{kb_id} \
  --header 'x-api-key: <api-key>'
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}
Permanently delete a knowledge base and all its documents. This action cannot be undone.

​
Path Parameters

​
kb_id
string
required
Unique identifier of the knowledge base to delete (UUID format)

​
Response

Returns 204 No Content or 202 Accepted on successful deletion.

​
Notes

  • All documents in the knowledge base will be permanently removed
  • Agents using this knowledge base will lose access to it
  • This action cannot be undone
  • You can also delete knowledge bases through the web dashboard at https://app.xpander.ai

​
Example Request

curl -X DELETE -H "x-api-key: YOUR_API_KEY" \
  https://api.xpander.ai/v1/knowledge/4be18afd-ccbd-4092-8686-75e9df2a1bec

​
Example Response

HTTP/1.1 202 Accepted
Content-Type: application/json

null
The endpoint returns 202 Accepted to indicate the deletion request has been accepted and will be processed.

Authorizations

​
x-api-key
string
header
required

API Key for authentication

Path Parameters

​
kb_id
string
required

Response

Successful Response