---
title: "Delete Knowledge Base"
method: DELETE
path: "/knowledge_bases/v2/{kb_id}"
tags: ["Knowledge Bases V2"]
deprecated: true
---

# Delete Knowledge Base

`DELETE /knowledge_bases/v2/{kb_id}`

> **Deprecated.**

Soft delete a knowledge base and clean up associated vector data.

This endpoint:
1. Verifies KB exists and user has permission
2. Soft deletes all chunks (sets is_deleted=True, deleted_at, deleted_by in lightrag_doc_chunks)
3. Deletes all vectors from Weaviate (by workspace filter)
4. Soft deletes all documents (sets is_deleted=True, deleted_at, deleted_by in knowledge_documents)
5. Soft deletes the knowledge base (sets is_deleted=True)
6. Preserves chunk access logs for analytics
7. 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.

## Path parameters

- `kb_id` integer, required

## Response `200`

Successful Response

- unknown

## Other responses

- `403` — Permission denied
- `404` — Knowledge base not found
- `422` — Validation Error

---

[API](https://skmtc.net/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.net/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myaltimate/fastapi/versions/aab3fe5c9f05/schema)