v5
latestOpenAPI 3.1.02026-08-081,0211,3082.1 MBKnowledge Bases V2
Delete Knowledge Base
Soft delete a knowledge base and clean up associated vector data.
This endpoint:
- Verifies KB exists and user has permission
- Soft deletes all chunks (sets is_deleted=True, deleted_at, deleted_by in lightrag_doc_chunks)
- Deletes all vectors from Weaviate (by workspace filter)
- Soft deletes all documents (sets is_deleted=True, deleted_at, deleted_by in knowledge_documents)
- Soft deletes the knowledge base (sets is_deleted=True)
- Preserves chunk access logs for analytics
- Leaves S3 files intact (for audit/recovery purposes)
Note: The knowledge base can be restored by setting is_deleted=False, but vector data will need to be re-ingested from the preserved chunks.
delete/knowledge_bases/v2/{kb_id}
Path parameters
kb_idinteger required
Response
Successful Response
{"stackTrail":"paths:/knowledge_bases/v2/{kb_id}:delete:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}