v1
latestOpenAPI 3.1.02026-07-2618690613.4 KBFolders
Delete folder
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
delete/v1/folders/{folderId}
Path parameters
folderIdstring uuid required
The UUID of the folder to delete. Use the List folders endpoint to retrieve folder IDs.
Query parameters
forceboolean
When true, recursively archives documents (to trash) and deletes sub-folders. Limited to 100 total items.
Response
Folder deleted successfully
Example response
{
"success": true
}