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

Le nouveau nom du dossier, qui mettra également à jour le chemin d'accès complet et tous les sous-dossiers du dossier.

parentFolderId
integer<int64>

L'ID du nouveau dossier parent, qui déplacera le dossier et ses sous-dossiers vers le dossier spécifié.

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