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

Requires one of the following products or higher.
Marketing HubMarketing Hub -Free
Sales HubSales Hub -Free
Service HubService Hub -Free
Content HubContent Hub -Free
Data HubData Hub -Free

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

The new name for the folder, which will also update the fullPath and all children of the folder.

​
parentFolderId
integer<int64>

The ID of the new parent folder, which will move the folder and its children into the specified folder.

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 December 16, 2025