---
title: "Delete a folder and all its contents from S3"
method: DELETE
path: "/api/assets/folder"
tags: ["Assets - Admin"]
---

# Delete a folder and all its contents from S3

`DELETE /api/assets/folder`

Delete a folder and everything under it (STAGING). Recursive and irreversible.

The frontend picker has always called this route; it simply did not exist
(only `POST /assets/folder` did), so "Eliminar pasta" was 405-ing.

Plain `def`, not `async def`: this walks an unbounded prefix and issues
blocking boto3 calls, which on the event loop would starve every other
request (docs/claude/10-api-patterns.md). FastAPI runs `def` in a threadpool.

## Query parameters

- `folder_path` string, required — Folder path to delete (relative to assets/)

## Headers

- `x-website-token` string, nullable
- `x-api-token` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/multigest/apis/multigest-protected-api.md) · [All operations](https://skmtc.dev/multigest/apis/multigest-protected-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/multigest/multigest-protected-api/revisions/4b44eb76b3ee/schema)