---
title: "Update a folder"
method: PATCH
path: "/api/v1/folders/{folderId}"
tags: ["Folders"]
---

# Update a folder

`PATCH /api/v1/folders/{folderId}`

Update a folder's display name and/or URL path segment. At least one of `name` or `path` must be provided. Changing the name does not automatically update the path. When the path is updated, descendant folder paths are cascaded.

## Path parameters

- `folderId` string, uuid, required — Unique identifier for the folder

## Request body

- FoldersUpdateBody
  - `breadcrumbRoot` boolean — When true, breadcrumbs for content in this folder start at this folder, hiding parent folders
  - `name` string — New display name for the folder
  - `path` string — New URL path segment for the folder (alphanumeric and dashes only). This is only the folder's own segment, not the full hierarchical path.
  - `resolvePathConflict` boolean — When true, automatically resolves path collisions with existing folders by appending a numeric suffix (e.g., my-path-1). When false (default), returns 409 Conflict if the path is already taken. Does not apply to reserved paths, which are always rejected with 400.

## Response `200`

Folder updated successfully

- FoldersUpdateResponse
  - `breadcrumbRoot` boolean, required — Whether breadcrumbs start at this folder
  - `id` string, uuid, required — Folder ID
  - `name` string, required — Updated folder name
  - `path` string, required — Updated URL path segment for the folder (the folder's own segment only)

## Other responses

- `400` — Invalid request body (empty name, invalid path characters, reserved path, an unrecognized field, or neither field provided)
- `401` — Authentication required
- `403` — Permission denied - EDITOR role required
- `404` — Folder not found
- `409` — Path conflicts with an existing folder (when resolvePathConflict is false)

---

[API](https://skmtc.net/omniapp/apis/omni-api.md) · [All operations](https://skmtc.net/omniapp/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omniapp/omni-api/versions/4701f292c621/schema)