---
title: "Delete a Team folder"
method: DELETE
path: "/api/team/v1/folders/{id}"
tags: ["Team folders"]
---

# Delete a Team folder

`DELETE /api/team/v1/folders/{id}`

## Request

- Base URL: `https://mdflow.cz`
- URL: `https://mdflow.cz/api/team/v1/folders/{id}`
- Auth: HTTP bearer

Permanently deletes a Team folder together with every subfolder and document inside it, including their images and attached files. Requires write access to the folder's workspace. Recorded in the Team audit feed under the token's creator.

## Path parameters

- `id` string, uuid, required

## Response `204`

Deleted successfully. No response body.

## Other responses

- `400`: Request body was malformed or failed validation.
- `401`: Missing, malformed, invalid, or revoked Team access token — including a personal `mdf_` token sent to a Team route, and a token whose creator has left the team. The body includes a `message` with Team token guidance, and the response carries a `WWW-Authenticate` challenge.
- `403`: The Team access token is valid but the operation exceeds its effective access: a write from a read-only token or from a creator whose current workspace permission is read-only, a write while the Team account is not active (setup, grace, or read_only), or any request while the account is being deleted. No plan check is involved — eligibility comes from the Team seat. The body includes a `message` with guidance.
- `404`: The folder does not exist in a workspace the token can read.
- `429`: The token or authenticated user exceeded a 60 requests per minute rate limit.
- `500`: Unexpected server error, or the live membership lookup failed. Retry rather than discarding the token — this is never a revocation signal.

---

[API](https://skmtc.dev/mdflow/apis/mdflow-public-api.md) · [All operations](https://skmtc.dev/mdflow/apis/mdflow-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mdflow/apis/mdflow-public-api/revisions/3691fc5d1688?raw)