---
title: "Move a folder"
method: POST
path: "/api/notebooks/{notebook}/folders/{folder}/move"
tags: ["notebook-controller"]
---

# Move a folder

`POST /api/notebooks/{notebook}/folders/{folder}/move`

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).

## Path parameters

- `notebook` integer, required
- `folder` integer, required

## Request body

- FolderMoveRequest — Move a folder to a new parent in the same notebook, or to another notebook when destinationNotebookId is set. Omit newParentFolderId or set it to null to place the folder at notebook root.
  - `newParentFolderId` integer — Target parent folder id. When null or omitted, the folder is moved to notebook root.
  - `destinationNotebookId` integer — Destination notebook id for a cross-notebook move. When null or omitted, the folder stays in the path notebook.
  - `merge` boolean — 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 `200`

OK

---

[API](https://skmtc.net/nerds-odd-e/apis/openapi-definition.md) · [All operations](https://skmtc.net/nerds-odd-e/apis/openapi-definition/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nerds-odd-e/openapi-definition/versions/f04215d476a6/schema)