---
title: "Update folder properties"
method: POST
path: "/files/2026-03/folders/update/async"
tags: ["Folders"]
---

# Update folder properties

`POST /files/2026-03/folders/update/async`

Update properties of folder by given ID. This action happens asynchronously and will update all of the folder's children as well.

## Request body

- FilesFolderUpdateInputWithId
  - `id` string, required — The unique identifier of the folder to be updated.
  - `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 `202`

accepted

- FilesFolderUpdateTaskLocator
  - `id` string, required — ID of the task
  - `links` object — Links for where to check information related to the task. The `status` link gives the URL for where to check the status of the task.

## 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/revisions/f9c7181056c5/schema)