Delete a knowledge base

DELETE 
/ai/knowledgebases/:id

Deletes a knowledge base and associated resources. Fails if it is still attached to any projects. Structured knowledge bases are deleted synchronously; unstructured ones are set to DELETING and removed asynchronously. Requires owner access. No request body.

Request

Responses

200

Structured deletion Message is "Knowledge base deleted successfully". Unstructured deletion Message is "Knowledge base deletion started successfully".

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

400

Input validation or authorization failure. Body is {"Message": " - "}. Codes: AI-1003 (attached to projects or agents), AUTH-1012 (not owner), AUTH-1001 (missing role_id), AUTH-1011 (caller not authorized).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

404

Knowledge base not found. Body is {"Message": " - "}. Code: IPV-1002.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

500

Backend failure. Body is {"Message": " - "}. Codes: GE-1085 (unexpected backend failure), DB-1002 (persistence failure).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers