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

# Delete a folder

`DELETE /api/v1/folders/{folderId}`

Deletes a folder. By default, non-empty folders (containing documents or sub-folders) return a 400 error. Pass `force=true` to recursively archive all documents (soft-delete to trash) and permanently remove all sub-folders before deleting the target folder. Force delete is limited to 100 total items (documents + sub-folders).

## Path parameters

- `folderId` string, uuid, required — Unique identifier for the folder

## Query parameters

- `force` boolean, nullable — When true, recursively deletes all documents (sent to trash) and sub-folders within the folder. Limited to 100 total items (documents + sub-folders).

## Response `200`

Folder deleted successfully

- FoldersDeleteResponse
  - `success` boolean, required — Whether the folder was deleted successfully

## Other responses

- `400` — Folder cannot be deleted (e.g., contains documents or sub-folders and force is not set, or force delete exceeds the 100-item limit)
- `401` — Authentication required
- `403` — Permission denied - cannot view or delete folder
- `404` — Folder not found

---

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