Skip to main content
POST
/
files
/
v3
/
folders
/
update
/
async
Update folder properties
curl --request POST \
  --url https://api.hubapi.com/files/v3/folders/update/async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "<string>",
  "name": "<string>",
  "parentFolderId": 123
}
'
{
  "id": "57122e26-59f8-4cfc-ba53-96e30c816762",
  "links": [
    {
      "status": "https://api.hubspot.com/files/v3/folders/update/async/tasks/57122e26-59f8-4cfc-ba53-96e30c816762/status"
    }
  ]
}

Supported products

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
​
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<int64>

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

accepted

Information on the task that has been started, and where to check it's status.

​
id
string
required

ID of the task

​
links
object
required

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.

Last modified on February 12, 2026