---
title: "Update folder properties by folder ID"
method: PATCH
path: "/files/2026-03/folders/{folderId}"
tags: ["Folders"]
---

# Update folder properties by folder ID

`PATCH /files/2026-03/folders/{folderId}`

Update a folder's properties, identified by folder ID.

## Path parameters

- `folderId` string, required

## Request body

- FilesFolderUpdateInput
  - `name` string — New name. If specified the folder's name and fullPath will change. All children of the folder will be updated accordingly.
  - `parentFolderId` integer — New parent folderId. If changed, the folder and all it's children will be moved into the specified folder. parentFolderId and parentFolderPath cannot be specified at the same time.

## Response `200`

successful operation

- FilesFolder
  - `archived` boolean, required — Marks whether the folder is deleted or not.
  - `archivedAt` string, date-time — Timestamp of folder deletion.
  - `createdAt` string, date-time, required — Timestamp of folder creation.
  - `id` string, required — ID of the folder.
  - `name` string — Name of the folder.
  - `parentFolderId` string — ID of the parent folder.
  - `path` string — Path of the folder in the file manager.
  - `updatedAt` string, date-time, required — Timestamp of the latest update to the folder.

## Other responses

- `default` — An error occurred.

---

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