Zum Hauptinhalt springen
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 '{
  "parentFolderId": 123,
  "name": "<string>",
  "id": "<string>"
}'
{
  "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 HubGratuit
Sales HubSales HubGratuit
Service HubService HubGratuit
Content HubContent HubStarter

​
Portées requises

Cette API requiert l’une des portées suivantes :
  • files

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

Identifiant unique du dossier à mettre à jour.

​
parentFolderId
integer

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

​
name
string

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

Response

accepted

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

​
links
object
required

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.

Example:

"[{\"status\":\"https://api.hubspot.com/files/v3/folders/update/async/tasks/57122e26-59f8-4cfc-ba53-96e30c816762/status\"}]"

​
id
string
required

ID de la tâche

Example:

"57122e26-59f8-4cfc-ba53-96e30c816762"