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

# Delete a folder

`DELETE /folders/{id}`

## Request

- Base URL: `https://api5.optimove.net/content/v1`
- URL: `https://api5.optimove.net/content/v1/folders/{id}`
- Auth: API key in header `X-API-KEY`

Deletes an empty folder. A folder that still contains subfolders, templates or blocks can't be deleted.

## Response `204`

The folder was deleted.

## Other responses

- `401`: The `X-API-KEY` header is missing or the API key is not valid.
- `403`: The API key doesn't have the admin role, or the tenant isn't allowed to change this item.
- `404`: The folder, or the new parent folder, doesn't exist.
- `422`: The folder can't be moved under itself or one of its subfolders, or can't be deleted because it isn't empty.
- `429`: The tenant's rate limit is reached. Retry after the time in `x-ratelimit-reset`.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/optimove/apis/content-api.md) - [All operations](https://skmtc.dev/optimove/apis/content-api/llms.txt) - [OpenAPI document](https://skmtc.dev/optimove/apis/content-api/revisions/2f4f55f36f0e?raw)