Vault

Move and/or rename a note

Index-cache-only relocation (no blob touch); the id is stable so asset referrer sets never dangle. Rename folds into move for notes: pass newName to rename, omit it to keep the current name. Returns the relocated note as a bare tree node (children omitted; move does not touch content or updatedAt).

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

Request

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

Path parameters

idstring required

The note's stable id.

Request body

newParentPathstring required

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

newNamestring

New leaf name; omit to keep the current name.

Response

The relocated note 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.