Skip to content
LydieDevelopers
Menu

Move a document

View as Markdown
POST/v1/documents/{id}/move

Moves a document (and its subtree) under a new parent, or to the top level with parentId null. Without afterId/beforeId it becomes the last child.

docs:writeUndoable
Request
curl -X POST "https://api.lydie.co/v1/documents/01JCQ3V5MZ8G4ZK2X7T9R6N1PB/move" \
  -H "Authorization: Bearer $LYDIE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "parentId": null
  }'

Path parameters

  • idULIDrequired

Body

  • parentIdULIDor nullrequired
  • afterIdULID

    Place directly after this sibling.

  • beforeIdULID

    Place directly before this sibling.

  • sortKeystring· 1–256 chars

    Explicit fractional key. Overrides afterId/beforeId; recorded by clients so replays converge.

Response

200
{
  "id": "01JCQ3V5MZ8G4ZK2X7T9R6N1PB",
  "workspaceId": "01JCQ3TZ0WJ8K4M2X7T9R6N1PA",
  "parentId": null,
  "title": "Meeting notes",
  "sortKey": "a0",
  "properties": {
    "status": "draft"
  },
  "createdAt": "2026-11-12T09:30:00.000Z",
  "updatedAt": "2026-11-12T09:30:00.000Z",
  "deletedAt": null,
  "createdBy": null,
  "updatedBy": null
}

Errors use one envelope for every endpoint. See Errors and versions.