Folders

Delete folders by id (idempotent)

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.

post/api/folders/batch-delete

Request

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

Request body

idsstring[] required

Example request

{
  "ids": [
    "9f1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
    "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d"
  ]
}

Response

Deleted count

deletedinteger required

Example response

{
  "deleted": 3
}

Changes

No recorded changes to this operation across all 1 revision of this API.