Delete folders by id (idempotent)

POST

/folders/batch-delete

curl --request POST \
  --url https://api.engram.page/folders/batch-delete \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "ids": [ "9f1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d", "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d" ] }'

• Production

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.

Authorizations

• bearerAuth

Request Body^required

Folder ids

Media typeapplication/json

BatchIdsRequest

object

ids

required

Array<string>

Example

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

Responses

200

Deleted count

Media typeapplication/json

DeletedCount

object

deleted

required

integer

Example

{
  "deleted": 3
}

400

Invalid ids

Media typeapplication/json

Error

object

errors

One of:

string

string

object

object

Example^generated

{
  "errors": {}
}

404

Some ids not found

Media typeapplication/json

Error

object

errors

One of:

string

string

object

object

Example^generated

{
  "errors": {}
}

409

Conflict

Media typeapplication/json

Error

object

errors

One of:

string

string

object

object

Example^generated

{
  "errors": {}
}