Zum Hauptinhalt springen
POST
/
files
/
v3
/
folders
/
update
/
async
Ordnereigenschaften aktualisieren
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"
    }
  ]
}

Unterstützte Produkte

Erfordert eines der folgenden Produkte oder höher.
Marketing HubMarketing Hub -Kostenlos
Sales HubSales Hub -Kostenlos
Service HubService Hub -Kostenlos
Content HubContent Hub -Kostenlos

Autorisierungen

Authorization
string
header
erforderlich

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

Body

application/json
id
string
erforderlich

Die eindeutige ID des zu aktualisierenden Ordners.

name
string

Neuer Name. Sofern angegeben, werden „name“ und „fullPath“ des Ordners geändert. Alle Unterordner des Ordners werden entsprechend aktualisiert.

parentFolderId
integer<int64>

Neue übergeordnete „folderId“. Bei einer Änderung werden der Ordner und alle Unterordner in den angegebenen Ordner verschoben. „parentFolderId“ und „parentFolderPath“ können nicht gleichzeitig festgelegt werden.

Antwort

accepted

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

id
string
erforderlich

ID der Aufgabe

Links zum Abrufen von Informationen, die sich auf die Aufgabe beziehen. Der „Status“-Link enthält die URL, unter der der Status der Aufgabe angezeigt werden kann.

Last modified on February 12, 2026