HUhubspot
Folders

Update folder

Changed on

Update the details of a specific folder in the file manager by providing the folder's unique identifier. This operation allows you to modify folder attributes such as its name or parent folder ID.

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

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/files/2026-09/folders/{folderId}
  • Auth
    OAuth 2
    Authorization code: https://app.hubspot.com/oauth/authorize
    Token URL: https://api.hubapi.com/oauth/v1/token scopes: files.ui_hidden.write

Path parameters

folderIdstring required

The ID of the folder to update.

Request body

namestring

The new name for the folder.

parentFolderIdinteger

The ID of the parent folder to which this folder will be moved.

Response

successful operation

archivedboolean required

A boolean indicating whether the folder is archived.

archivedAtstring date-time

The date and time when the folder was archived, in ISO 8601 format.

createdAtstring date-time required

The date and time when the folder was created, in ISO 8601 format.

idstring required

The unique ID for the folder, represented as a string.

namestring

The name of the folder, represented as a string.

parentFolderIdstring

The unique identifier of the parent folder, represented as a string.

pathstring

The path of the folder within the file system, represented as a string.

updatedAtstring date-time required

The date and time when the folder was last updated, in ISO 8601 format.

Changes

  • 2026-098f8b7750e626Revision changes
    • info

      api tag Folders added

    • info

      api tag Basic removed

  • 2026-096e0d1e97cb30Revision changes
    • info

      the security scope files.ui_hidden.write was added to the endpoint's security scheme oauth2

    • info

      the security scope files.write was removed from the endpoint's security scheme oauth2