Notes

Move notes to a folder (idempotent)

Moves multiple notes into the folder identified by target_folder_id (or the literal "root" for the vault root) in one transaction and returns the moved count. Requires the X-Idempotency-Key header. Returns 404/409 (with item_id) if any id is missing or conflicts.

post/api/notes/batch-move

Request

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

Request body

idsstring[] required

target_folderstring

Destination folder path (alternative to target_folder_id; "" = vault root). Use this to move into a derived folder that has no marker.

target_folder_idstring

Folder UUID or "root".

Example request

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

Response

Moved count

movedinteger required

Example response

{
  "moved": 3
}

Changes

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