Passer au contenu principal
POST
/
files
/
v3
/
folders
/
update
/
async
Mettre à jour les propriétés du dossier
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"
    }
  ]
}

Produits pris en charge

Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing Hub -Gratuit
Sales HubSales Hub -Gratuit
Service HubService Hub -Gratuit
Content HubContent Hub -Gratuit

Autorisations

Authorization
string
header
requis

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

Corps

application/json
id
string
requis

Identifiant unique du dossier à mettre à jour.

name
string

Nouveau nom. Si spécifié, le nom du dossier et fullPath changeront. Tous les dossiers enfants seront mis à jour en conséquence.

parentFolderId
integer<int64>

Nouvel ID de dossier parent. S'il est modifié, le dossier et tous les dossiers enfants seront déplacés dans le dossier spécifié. parentFolderId et parentFolderPath ne peuvent pas être spécifiés en même temps

Réponse

accepted

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

id
string
requis

ID de la tâche

Liens pour vérifier les informations relatives à la tâche. Le lien « statut » donne l'URL pour vérifier le statut de la tâche.

Last modified on February 12, 2026