---
title: "Update folder"
method: PATCH
path: "/files/2026-09-beta/folders/{folderId}"
tags: ["Basic"]
---

# Update folder

`PATCH /files/2026-09-beta/folders/{folderId}`

Update the details of a specific folder in the file manager by providing the folder's unique identifier. This operation allows you to modify folder attributes such as its name or parent folder ID.

## Path parameters

- `folderId` string, required

## Request body

- FolderUpdateInput
  - `name` string — The new name for the folder.
  - `parentFolderId` integer — The ID of the parent folder to which this folder will be moved.

## Response `200`

successful operation

- Folder
  - `archived` boolean, required — A boolean indicating whether the folder is archived.
  - `archivedAt` string, date-time — The date and time when the folder was archived, in ISO 8601 format.
  - `createdAt` string, date-time, required — The date and time when the folder was created, in ISO 8601 format.
  - `id` string, required — The unique ID for the folder, represented as a string.
  - `name` string — The name of the folder, represented as a string.
  - `parentFolderId` string — The unique identifier of the parent folder, represented as a string.
  - `path` string — The path of the folder within the file system, represented as a string.
  - `updatedAt` string, date-time, required — The date and time when the folder was last updated, in ISO 8601 format.

## Other responses

- `default` — An error occurred.

## Changes

- **2026-09-02** (2026-09-beta) `58219b4e69e2` — 2 info
  - the security scope `files.ui_hidden.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `files.write` was removed from the endpoint's security scheme `oauth2`
- **2026-08-17** (2026-09-beta) `e45d1bdf10a4` — 1 info
  - endpoint added
- **2026-07-13** (2026-09-beta) `0685ec3d09b4` — 1 breaking
  - api path removed without deprecation
- **2026-07-13** (2026-09-beta) `2948e097f463` — 1 info
  - endpoint added
- **2026-07-13** (2026-09-beta) `0e6a6e6ac0c1` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/hubspot/apis/files-files/changes/files/2026-09-beta/folders/:folderId/patch.md)

---

[API](https://skmtc.dev/hubspot/apis/files-files.md) · [All operations](https://skmtc.dev/hubspot/apis/files-files/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hubspot/files-files/revisions/58219b4e69e2/schema)