Zum Hauptinhalt springen
GET
/
files
/
v3
/
folders
/
update
/
async
/
tasks
/
{taskId}
/
status
Status der Ordneraktualisierung überprüfen
curl --request GET \
  --url https://api.hubapi.com/files/v3/folders/update/async/tasks/{taskId}/status \
  --header 'Authorization: Bearer <token>'
{
  "completedAt": "2023-11-07T05:31:56Z",
  "startedAt": "2023-11-07T05:31:56Z",
  "status": "CANCELED",
  "taskId": "<string>",
  "errors": [
    {
      "category": "<string>",
      "context": {},
      "errors": [
        {
          "message": "<string>",
          "code": "<string>",
          "context": "{missingScopes=[scope1, scope2]}",
          "in": "<string>",
          "subCategory": "<string>"
        }
      ],
      "links": {},
      "message": "<string>",
      "status": "<string>",
      "id": "<string>",
      "subCategory": {}
    }
  ],
  "links": {},
  "numErrors": 123,
  "requestedAt": "2023-11-07T05:31:56Z",
  "result": {
    "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

taskId
string
erforderlich

Die ID der Aufgabe der Ordneraktualisierung.

Antwort

successful operation

completedAt
string<date-time>
erforderlich

Ob alle erforderlichen Änderungen berücksichtigt wurden.

startedAt
string<date-time>
erforderlich

Zeitstempel, wann die Aufgabe gestartet wurde.

status
enum<string>
erforderlich

Aktueller Status der Aufgabe.

Verfügbare Optionen:
CANCELED,
COMPLETE,
PENDING,
PROCESSING
taskId
string
erforderlich

ID der Aufgabe.

errors
object[]

Ausführliche Angaben zu den Fehlern, die sich aus der Aufgabe ergeben.

Link zur Überprüfung des Status der Aufgabe.

numErrors
integer<int32>

Anzahl der Fehler, die sich aus den angeforderten Änderungen ergeben.

requestedAt
string<date-time>

Zeitstempel, wann die Aufgabe angefragt wurde.

result
object
Last modified on December 8, 2025