Delete Knowledge Base

Endpoint

DELETE /apiops/projects/{projectName}/knowledge-bases/{name}/

Authentication

Requires a Personal API Access Token.

Header

Authorization: Bearer YOUR_TOKEN

Request

Headers

Header	Value	Required
Authorization	Bearer {token}	Yes

Path Parameters

Parameter	Type	Required	Description
projectName	string	Yes	Project name
name	string	Yes	Knowledge base name

Query Parameters

None

Response

Success Response (200 OK)

{
  "status": "SUCCESS",
  "deploymentResult": {
    "success": true
  }
}

Error Response (400 Bad Request)

{
  "status": "FAILURE",
  "resultMessage": "Knowledge base (name: product-docs) was not found!"
}

or

{
  "status": "FAILURE",
  "resultMessage": "Knowledge base name can not be empty!"
}

Error Response (401 Unauthorized)

{
  "status": "FAILURE",
  "resultMessage": "Token is not valid!"
}

cURL Example

curl -X DELETE \
  "https://demo.apinizer.com/apiops/projects/MyProject/knowledge-bases/product-docs/" \
  -H "Authorization: Bearer YOUR_TOKEN"

Notes and Warnings

• Cascade Delete: Deleting a knowledge base also removes all of its documents and purges its VectorDB collection. This operation is irreversible.
• Fail-Soft VectorDB Purge: The VectorDB collection purge is best-effort; a temporary vector-store outage does not block removal of the knowledge base from the manager.
• Name-Based: The knowledge base is resolved by name within the project before deletion.
• Not Found: Deleting a non-existent name returns 400 Bad Request.
• Permissions: Requires AI_DEVELOPMENT + MANAGE permission in the project.

Related Documentation

• Create Knowledge Base - Create or update a knowledge base
• Delete Document - Remove a single document instead of the whole knowledge base
• Knowledge Bases API - Resource overview