notebook-folder-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

Changes

Changed in 6 of the 195 revisions of this API.46

    • ○

      api tag notebook-folder-controller added

      api-tag-added

    • ○

      api tag notebook-controller removed

      api-tag-removed

  • 13f77438750e11See the full diff
    • ●

      removed the optional property from the response with the status

      response-optional-property-removed

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ●

      removed the request property

      request-property-removed

    • ●

      removed the request property

      request-property-removed

    • ●

      removed the optional property from the response with the status

      response-optional-property-removed

    This revision also has 17 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog