Vault

Move a folder under a new parent

Reparents the folder; the whole subtree moves with it, ids stable. Moving a folder into itself or its own subtree is 400 invalid_move. Returns the moved folder as a bare tree node.

post/v1/vault/folders/{id}/move

Request

  • Base URL: http://localhost:9998
  • URL: http://localhost:9998/v1/vault/folders/{id}/move
  • Auth: HTTP bearer

Path parameters

idstring required

The folder's stable id.

Request body

newParentPathstring required

New parent folder's vault-relative path ('' for the vault root).

Response

The moved folder as a bare tree node

idstring required

Stable random UUID; unchanged by move/rename.

kind'folder' | 'note' required

Whether a vault tree node is a folder or a note.

namestring required

Leaf display name, no path.

pathstring required

Vault-relative, '/'-separated path, e.g. "ideas/2026/pitch".

childrenWireVaultTreeNode[] circular

Changes

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