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

# Delete notes by id (idempotent)

`POST /api/notes/batch-delete`

## Request

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

Deletes multiple notes by id in a single transaction and returns the deleted count. Requires the `X-Idempotency-Key` header for safe retries. 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)