---
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. Notes keep their folderId pointing at the same folder rows; descendant folders stay under the moved subtree.

## Path parameters

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

## Request body

- FolderMoveRequest — Move a folder to a new parent in the same notebook. 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.

## Response `200`

OK

## Changes

- **2026-05-12** `de5624b4a98c` — 1 info
  - added the optional property `indexContent` to the response with the `200` status
- **2026-05-11** `d7c2946139e9` — 3 warning
  - removed the request property `destinationNotebookId`
  - removed the request property `merge`
  - removed the optional property `indexContent` from the response with the `200` status

[Change history](https://skmtc.dev/nerds-odd-e/apis/openapi-definition/changes/api/notebooks/:notebook/folders/:folder/move/post.md)

---

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