---
title: "Delete a folder recursively"
method: DELETE
path: "/v1/vault/folders/{id}"
tags: ["Vault"]
---

# Delete a folder recursively

`DELETE /v1/vault/folders/{id}`

## Request

- Base URL: `http://localhost:9998`
- URL: `http://localhost:9998/v1/vault/folders/{id}`
- Auth: HTTP bearer

Deletes the folder and every descendant note and folder, in the same
index-persist-before-reclaim order as note delete.

## Path parameters

- `id` string, required

## Response `200`

Deletion acknowledged

- WireVaultDeleteResponse: Acknowledges a note or folder deletion (folder delete is recursive).
  - `id` string, required
  - `deleted` boolean, required

## Other responses

- `400`: Invalid request
- `404`: Resource not found
- `423`: The vault is locked (no VMK loaded). Unlock natively in ToolPiper — there is no unlock route. The body is the standard nested error envelope with type `vault_locked`.
- `503`: Vault service unavailable

---

[API](https://skmtc.dev/modelpiper/apis/toolpiper-api.md) · [All operations](https://skmtc.dev/modelpiper/apis/toolpiper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/modelpiper/apis/toolpiper-api/revisions/6722bf56385c?raw)