Vault

Create a folder

Creates a folder marker blob under parentPath. Empty folders are first-class — the marker is what lets one survive an index rebuild. Returns the new folder as a bare tree node.

post/v1/vault/folders

Request

  • Base URL: http://localhost:9998
  • URL: http://localhost:9998/v1/vault/folders
  • Auth: HTTP bearer

Request body

parentPathstring required

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

namestring required

Leaf name for the new folder.

Response

The created 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.