# Delete a document folder

> The delete_document_folder MCP tool: delete a document folder.

`delete_document_folder` · writes · destructive

[REST: `DELETE /v1/document-folders/{folderId}`](https://api.bymundi.com/docs/reference/documents.folders.delete.md)

## What the model reads

Deletes a document folder. Its documents are NOT deleted: they become loose (in no folder) and keep their visibility. undo_change re-creates the folder and files back the documents that are still loose.

Permissions: documents:write.
Undo: the result names a change id; undo_change reverts it.

## Input

| Field | Type | Required | Description |
|---|---|---|---|
| `folderId` | uuid | yes |  |

## Input schema (JSON)

```json
{
  "type": "object",
  "properties": {
    "folderId": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "folderId"
  ],
  "additionalProperties": false
}
```