Delete Folder
DELETE/apiv2/pub/folders/{folder_id}documents_write
Permanently deletes a folder and all subfolders. Documents exclusively in this subtree are permanently deleted. Documents also in other folders are only unlinked.
Request
Path parameters
| Parameter | Type | Description |
|---|---|---|
folder_id | integer | Folder to delete. |
Response
200 OK| Field | Type | Description |
|---|---|---|
folder_id | integer | The deleted folder. |
folders_deleted | integer | Total folders removed (including descendants). |
documents_deleted | integer | Documents permanently deleted (exclusive to subtree). |
mappings_removed | integer | Folder-document associations removed. |
Document deletion logic
| Location | Result |
|---|---|
| Only in this subtree | Permanently deleted (files, archives, groups, record) |
| In subtree and other folders | Unlinked only — document preserved |
Errors
| Status | Reason |
|---|---|
| 401 | Invalid or expired token |
| 404 | Folder not found or access denied |
cURL
curl -i -X DELETE "https://portal.docwize.com/apiv2/pub/folders/42" \
-H "Authorization: Bearer <ACCESS_TOKEN>"
{
"folder_id": 42,
"folders_deleted": 4,
"documents_deleted": 12,
"mappings_removed": 18
}