---
title: "Delete folder"
method: DELETE
path: "/knowledgeBase/{kbId}/folder/{folderId}"
tags: ["Knowledge Base"]
---

# Delete folder

`DELETE /knowledgeBase/{kbId}/folder/{folderId}`

Delete a folder and all its contents.

**Required permission:** WRITER or higher

**Cascade delete:**

All subfolders and records within will be permanently deleted.

**Warning:** This action is irreversible.

## Path parameters

- `kbId` string, required
- `folderId` string, required

## Response `200`

Folder deleted successfully

- FolderDeleteResponseSchema — Response returned by DELETE /knowledgeBase/{kbId}/folder/{folderId} (deleteFolder).
  - `success` boolean, required
  - `message` string, required

## Other responses

- `400` — Invalid request parameters
- `401` — Unauthorized - Valid bearer token required
- `403` — Forbidden. Possible reasons: - OAuth token lacks the `kb:delete` scope - User lacks OWNER permission on the knowledge base
- `404` — Knowledge base or folder not found

---

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