---
title: "Delete folders by id (idempotent)"
method: POST
path: "/api/folders/batch-delete"
tags: ["Folders"]
---

# Delete folders by id (idempotent)

`POST /api/folders/batch-delete`

## Request

- Base URL: `https://api.engram.page`
- URL: `https://api.engram.page/api/folders/batch-delete`
- Auth: HTTP bearer

Deletes multiple folders by marker id in a single transaction and returns the deleted count. Requires the `X-Idempotency-Key` header — a retry within the TTL replays the cached result. Returns 404/409 (with the offending `item_id`) if any id is missing or conflicts.

## Request body

- BatchIdsRequest
  - `ids` string[], required

## Response `200`

Deleted count

- DeletedCount
  - `deleted` integer, required

## Other responses

- `400`: Invalid ids
- `404`: Some ids not found
- `409`: Conflict

---

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