HUhubspot
Folders

Update folder properties by folder ID

Changed on

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

patch/files/2026-03/folders/{folderId}

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/files/2026-03/folders/{folderId}
  • Auth
    • HTTP bearer
    • or API key in query parameter hapikey
    • or none

Path parameters

folderIdstring required

Request body

namestring

New name. If specified the folder's name and fullPath will change. All children of the folder will be updated accordingly.

parentFolderIdinteger

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

successful operation

archivedboolean required

Marks whether the folder is deleted or not.

archivedAtstring date-time

Timestamp of folder deletion.

createdAtstring date-time required

Timestamp of folder creation.

idstring required

ID of the folder.

namestring

Name of the folder.

parentFolderIdstring

ID of the parent folder.

pathstring

Path of the folder in the file manager.

updatedAtstring date-time required

Timestamp of the latest update to the folder.

Changes

Some revisions have not been checked yet.