---
title: "Delete folder"
method: DELETE
path: "/folders/{folder_id}"
tags: ["Folders"]
---

# Delete folder

`DELETE /folders/{folder_id}`

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

## Path parameters

- `folder_id` string, required

## Query parameters

- `recursive` boolean

## Headers

- `if-match` string

## Response `204`

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

## Other responses

- `400` — Returns an error if the user makes a bad request. * `folder_not_empty`: Returned if the folder is not empty. Use the `recursive` query parameter to recursively delete the folder and its contents.
- `403` — Returns an error if the user does not have the required access to perform the action. * `access_denied_insufficient_permissions`: Returned when the user does not have access to the folder, or when a folder lock has been applied to the folder to prevent deletion. * `insufficient_scope`: Returned an error if the application does not have the right scope to delete folders. Make sure your application has been configured to read and write all files and folders stored in Box.
- `404` — Returns an error if the folder could not be found, or the authenticated user does not have access to the folder. * `not_found` when the authenticated user does not have access to the folder.
- `409` — `operation_blocked_temporary`: Returned if the folder is locked due to another move, copy, delete or restore operation in progress. The operation can be retried at a later point.
- `412` — Returns an error when the `If-Match` header does not match the current `etag` value of the folder. This indicates that the folder has changed since it was last requested.
- `503` — Returns an error when the operation takes longer than 600 seconds. The operation will continue after this response has been returned.
- `default` — An unexpected client error.

---

[API](https://skmtc.net/box/apis/platform-api.md) · [All operations](https://skmtc.net/box/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/box/platform-api/versions/ba8f087e1a4d/schema)