---
title: "Rename a folder"
method: PATCH
path: "/api/notebooks/{notebook}/folders/{folder}"
tags: ["notebook-folder-controller"]
---

# Rename a folder

`PATCH /api/notebooks/{notebook}/folders/{folder}`

## Request

- Base URL: `` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/notebooks/{notebook}/folders/{folder}`
- Auth: none declared

Changes the folder display name under its current parent. Sibling name conflicts are rejected.

## Path parameters

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

## Request body

- FolderRenameRequest: Rename a folder in place within its current parent.
  - `name` string, required: New display name for the folder

## Response `200`

OK

- Folder
  - `id` integer, required
  - `readmeContent` string
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `parentFolderId` integer: Parent folder id when nested; omitted at notebook root.
  - `name` string, required

## Changes

- **2026-09-19** `b88bb26a237e`: 2 info
  - api tag `notebook-folder-controller` added
  - api tag `notebook-controller` removed
- **2026-08-19** `6c31eea0ac37`: 1 warning
  - changed the pattern of the request property `name` from `^[^\\/:]*$` to `^[\s\x00-\x1F]*[^\\/:*?"<>|\x00-\x1F]*[\s\x00-\x1F]*$`
- **2026-07-22** `13f77438750e`: 1 warning, 1 info
  - removed the optional property `indexContent` from the response with the `200` status
  - added the optional property `readmeContent` to the response with the `200` status
- **2026-05-14** `7e95b0b435af`: 1 info
  - endpoint added
- **2026-05-11** `d7c2946139e9`: 1 breaking
  - api removed without deprecation

[Operation history](https://skmtc.dev/nerds-odd-e/apis/odd-e-open-api/changes/api/notebooks/:notebook/folders/:folder/patch.md)

---

[API](https://skmtc.dev/nerds-odd-e/apis/odd-e-open-api.md) - [All operations](https://skmtc.dev/nerds-odd-e/apis/odd-e-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nerds-odd-e/apis/odd-e-open-api/revisions/193c5e89085a?raw)