Box Developer Documentation
Latest version

Permanently remove folder

delete
https://api.box.com/2.0
/folders/:folder_id/trash

This endpoint is in the version 2024.0. No changes are required to continue using it. For more details, see Box API versioning.

Permanently deletes a folder that is in the trash. This action cannot be undone.

Request

bearer [ACCESS_TOKEN]
application/json

Path Parameters

stringin pathrequired
12345

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.

Response

none

Returns an empty response when the folder was permanently deleted.

application/jsonClient error

Returns an error if the folder is not in the trash.

application/jsonClient error

An unexpected client error.

delete
Permanently remove folder
You can now try out some of our APIs live, right here in the documentation.
Log in