---
title: "Delete a folder"
method: DELETE
path: "/api/folders/{folderId}"
---

# Delete a folder

`DELETE /api/folders/{folderId}`

Deletes a folder. Use recursive=true to also delete child folders and archive their workspaces.

## Path parameters

- `folderId` string, required

## Query parameters

- `recursive` 'true' | 'false'

## Response `200`

Delete successful

- object
  - `success` boolean, required

## Other responses

- `400` — Invalid folder ID
- `401` — Missing or invalid bearer token
- `403` — Unauthorized
- `404` — Folder not found
- `500` — Internal server error

---

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