Folders

Move folders under a new parent (idempotent)

Re-parents multiple folders under target_parent_id (or the literal "root" for top level) in one transaction and returns the moved count. Requires the X-Idempotency-Key header. Returns 404 for a missing id and 409 (with item_id) on a conflict or a cycle.

post/api/folders/batch-move

Request

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

Request body

idsstring[] required
target_parentstring

Destination parent folder path (alternative to target_parent_id; "" = top level). Use this to re-parent under a derived folder that has no marker.

target_parent_idstring

Parent folder UUID or "root".

Example request

{
  "ids": [
    "3c4d5e6f-7a8b-9c0d-1e2f-3a4b5c6d7e8f",
    "4d5e6f7a-8b9c-0d1e-2f3a-4b5c6d7e8f90"
  ],
  "target_parent_id": "root"
}

Response

Moved count

movedinteger required

Example response

{
  "moved": 3
}

Changes

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