---
title: "Delete a folder"
method: DELETE
path: "/matters/{matterId}/documents/folders/{folderId}"
tags: ["Folders"]
---

# Delete a folder

`DELETE /matters/{matterId}/documents/folders/{folderId}`

Deletes a folder belonging to the specified matter.
            
An unknown folder id returns 400 rather than 404, because the folder may have been created but not yet processed.
The change is processed asynchronously; the returned Link continues to resolve the folder with `isDeleted: true` once applied.

## Path parameters

- `matterId` string, uuid, required
- `folderId` string, uuid, required

## Response `202`

When request is accepted. Returns a hypermedia 'Link' object of the folder to be deleted.

- Link
  - `id` string, nullable
  - `href` string, nullable
  - `relation` string, nullable
  - `method` string, nullable

## Other responses

- `400` — When a supplied id is not a valid GUID, or the folder does not exist or does not belong to the specified matter.

---

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