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

# Delete a folder

`DELETE /api/folders/{id}`

## Request

- Base URL: `https://morfee.furo.solutions`
- URL: `https://morfee.furo.solutions/api/folders/{id}`
- Auth: one of:
  - API key in header `X-Api-Key`
  - HTTP bearer

A folder is a shelf, not a container: what was on it is still there, in no folder.

Needs a key scoped `write` or `full`.

## Path parameters

- `id` string, required

## Response `200`

Deleted.

- object
  - `ok` boolean
  - `deleted` string
  - `hint` string

## Other responses

- `401`: No key, an unknown key or a revoked one.
- `403`: The key is real and the organization is right, but the scope on it does not cover this. The message names the scope the key has, what that scope may do, and how to get a wider one, because the thing reading it is usually the thing that has to act on it.
- `404`: Not there, or not yours. Both give the same answer on purpose: a different one would let a caller find out which ids exist in another organization.

---

[API](https://skmtc.dev/furo/apis/morfee.md) · [All operations](https://skmtc.dev/furo/apis/morfee/llms.txt) · [OpenAPI document](https://skmtc.dev/furo/apis/morfee/revisions/83f95f89653f?raw)