Sign in

v58

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01155144129.7 KB
notebook-controller

Move a folder

Reparents the folder within the same notebook, or moves the folder subtree to another notebook when destinationNotebookId is set. Notes keep their folderId pointing at the same folder rows; descendant folders stay under the moved subtree. A same-name folder at the destination returns 409 with FOLDER_NAME_CONFLICT unless merge=true, in which case the source subtree is merged into the existing folder (including cross-notebook moves).

post/api/notebooks/{notebook}/folders/{folder}/move

Path parameters

notebookinteger required
folderinteger required

Request body

newParentFolderIdinteger

Target parent folder id. When null or omitted, the folder is moved to notebook root.

destinationNotebookIdinteger

Destination notebook id for a cross-notebook move. When null or omitted, the folder stays in the path notebook.

mergeboolean

When true, merges the folder into an existing same-name sibling at the destination instead of returning 409. Subfolder name clashes are resolved recursively.

Response

OK