Zum Hauptinhalt springen
PATCH
/
files
/
v3
/
folders
/
{folderId}
Ordnereigenschaften nach Ordner-ID aktualisieren
curl --request PATCH \
  --url https://api.hubapi.com/files/v3/folders/{folderId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "parentFolderId": 123
}
'
{
  "archived": true,
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z",
  "archivedAt": "2023-11-07T05:31:56Z",
  "name": "<string>",
  "parentFolderId": "<string>",
  "path": "<string>"
}

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.

Pfadparameter

folderId
string
erforderlich

Body

application/json

Object for updating folders.

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

successful operation

archived
boolean
erforderlich

Kennzeichnet, ob der Ordner gelöscht wird oder nicht.

createdAt
string<date-time>
erforderlich

Zeitstempel der Ordnererstellung.

id
string
erforderlich

ID des Ordners.

updatedAt
string<date-time>
erforderlich

Zeitstempel der letzten Aktualisierung des Ordners.

archivedAt
string<date-time>

Zeitstempel der Ordnerlöschung.

name
string

Name des Ordners.

parentFolderId
string

ID des übergeordneten Ordners.

path
string

Pfad des Ordners im Datei-Manager.

Last modified on December 8, 2025