v1

latestOpenAPI 3.0.2Apache-2.02026-07-142963051.0 MB
Folders

Delete folder

Deletes a folder, either permanently or by moving it to the trash.

delete/folders/{folder_id}

Path parameters

folder_idstring required

The unique identifier that represent a folder.

The ID for any folder can be determined by visiting this folder in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/folder/123 the folder_id is 123.

The root folder of a Box account is always represented by the ID 0.

Query parameters

recursiveboolean

Delete a folder that is not empty by recursively deleting the folder and all of its content.

Headers

if-matchstring

Ensures this item hasn't recently changed before making changes.

Pass in the item's last observed etag value into this header and the endpoint will fail with a 412 Precondition Failed if it has changed since.

Response

Returns an empty response when the folder is successfully deleted or moved to the trash.