---
title: "Delete Knowledge Base Collection"
method: DELETE
path: "/knowledge-bases/{kbId}"
tags: ["Knowledge Base"]
---

# Delete Knowledge Base Collection

`DELETE /knowledge-bases/{kbId}`

## Request

- Base URL: `https://api.speakai.co/v1`
- URL: `https://api.speakai.co/v1/knowledge-bases/{kbId}`
- Auth: API key in header `x-speakai-key` and API key in header `x-access-token`

### Delete Collection

Requires the OWNER or ADMIN role. Deletes the collection, every document in it, their embeddings, and every mapping row pointing at it. An automation step that still names this collection is not touched -- it starts failing to retrieve rather than being silently unlinked.

## Path parameters

- `kbId` string, required

## Response `200`

OK

- object
  - `status` 'success'
  - `data` object
    - `knowledgeBaseId` string
    - `deleted` true

## Other responses

- `403`: Forbidden
- `404`: Not Found

---

[API](https://skmtc.dev/speakai/apis/speak-ai-api.md) · [All operations](https://skmtc.dev/speakai/apis/speak-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/speakai/apis/speak-ai-api/revisions/52d777e6d46e?raw)