---
title: "Delete Folder"
method: DELETE
path: "/v1/external/folders/{folderId}"
tags: ["Folder"]
---

# Delete Folder

`DELETE /v1/external/folders/{folderId}`

## Request

- Base URL: `https://api.tiro.ooo`
- URL: `https://api.tiro.ooo/v1/external/folders/{folderId}`
- Auth: HTTP bearer

Delete a folder. The folder must have no subfolders — delete or move its
children first. Requires edit access.

This action is irreversible.

## Path parameters

- `folderId` string, required

## Response `204`

Folder deleted

## Other responses

- `401`: Unauthorized — missing API key, or a team-only key was used
- `403`: Forbidden — no edit access to this folder
- `404`: Folder not found
- `422`: Unprocessable — the folder still has subfolders; delete or move them first

---

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