Delete a document folder
DELETE/v1/document-folders/{folderId}
Deletes a document folder, as Delete folder does. Its documents are NOT deleted: they become loose (in no folder) and keep their visibility. Undo with POST /changes/{changeId}/revert: it re-creates the folder and files back the documents that are still loose.
Permissions: documents:write · Kind: destructive · Cost: 1 unit · MCP tool delete_document_folder
Undoable: the response carries Bymundi-Change-Id; revert it with POST /v1/changes/{changeId}/revert.
Path parameters
| Field | Type | Required | Description |
|---|---|---|---|
folderId |
uuid | yes |
Query parameters
None.
Response 200
| Field | Type | Required | Description |
|---|---|---|---|
object |
"document_folder" | yes | |
id |
uuid | yes | |
deleted |
true | yes | |
documentsMoved |
integer | yes | Documents that were in it and are now loose — none is ever deleted with a folder. ≥ 0 |
Errors
Errors are problem details. Besides the refusals described above, any call like this one can return:
invalid_request— Invalid requestunauthorized— Missing or invalid API keyinsufficient_scope— Missing permissionrate_limited— Rate limit reachednot_found— Not foundidempotency_key_reused— Idempotency-Key reusedrequest_in_progress— Request in progressforbidden— Not allowed