---
title: "Delete folder"
method: DELETE
path: "/v1/folders/{folderId}"
tags: ["Folders"]
---

# Delete folder

`DELETE /v1/folders/{folderId}`

Delete a folder. By default, only empty folders can be deleted. Use the `force` parameter to recursively delete folders containing documents and sub-folders.

When `force` is enabled:

- All documents are archived (soft-delete to trash) across the folder tree
- Subfolders are deleted recursively, starting with the most deeply-nested subfolder and walking up the folder tree
- Up to 100 items (documents and subfolders) can be deleted. If a folder contains more than 100 items, the item will return a `400`. No items will be deleted.
- All operations occur in a single transaction - partial failures roll back completely
- SSO embed users cannot force-delete entity folders

## Path parameters

- `folderId` string, uuid, required

## Query parameters

- `force` boolean

## Response `200`

Folder deleted successfully

- SuccessResponse
  - `success` boolean

## Other responses

- `400` — Bad Request Possible error messages: - `Folders with documents cannot be deleted` (when `force=false` and folder is not empty) - `Only empty folders can be deleted` (when `force=false` and folder is not empty) - `Folder contains too many items to force delete. Found <count> items (limit: 100)` (when `force=true` and folder tree exceeds 100 items)
- `403` — Forbidden Possible error messages: - Permission denied (when user lacks delete permission) - SSO embed users cannot force-delete entity folders (when SSO embed user attempts to force-delete entity folder)
- `404` — Not Found Possible error messages: - `Folder with id <folderId> does not exist`
- `429` — Too Many Requests - Rate limit exceeded (60 requests/minute)

---

[API](https://skmtc.net/omni/apis/omni-api.md) · [All operations](https://skmtc.net/omni/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omni/omni-api/revisions/6b02f7349d0e/schema)