younifyd
Menu

Get /files/v3/folders/update/async/tasks/{task Id}/status Check Update Status

Check folder update status

GET/files/v3/folders/update/async/tasks/{taskId}/status

Use it in a workflow

  1. Add a step and choose the HubSpot connector.
  2. Pick the Get /files/v3/folders/update/async/tasks/{task Id}/status Check Update Status action (under Files).
  3. Fill in the fields below, then reference the result from later steps as {{getFilesV3FoldersUpdateAsyncTasksTaskIdStatusCheckUpdateStatus.response.data}}.

Request

Path parameters

taskIdstringrequired

TaskId of folder update

Response

Returns 200 with an object. Read it in later steps with {{getFilesV3FoldersUpdateAsyncTasksTaskIdStatusCheckUpdateStatus.response.data.<field>}}.

completedAtstring (date-time)

When the requested changes have been completed.

errorsarray<object>

Detailed errors resulting from the task.

categorystringrequired

The main category of the error.

contextobjectrequired

Additional context-specific information related to the error.

errorsarray<object>required5 fields

The detailed error objects.

idstring

A unique ID for the error instance.

linksobjectrequired

URLs linking to documentation or resources associated with the error.

messagestringrequired

A human-readable string describing the error and possible remediation steps.

statusstringrequired

The HTTP status code associated with the error.

subCategoryobject

A more specific error category within each main category.

linksobject

Link to check the status of the task.

numErrorsinteger (int32)

Number of errors resulting from the requested changes.

requestedAtstring (date-time)

Timestamp representing when the task was requested.

resultobject
archivedbooleanrequired

Marks whether the folder is deleted or not.

archivedAtstring (date-time)

Timestamp of folder deletion.

createdAtstring (date-time)required

Timestamp of folder creation.

idstringrequired

ID of the folder.

namestring

Name of the folder.

parentFolderIdstring

ID of the parent folder.

pathstring

Path of the folder in the file manager.

updatedAtstring (date-time)required

Timestamp of the latest update to the folder.

startedAtstring (date-time)

Timestamp representing when the task was started at.

statusstring

Current status of the task.

One ofCANCELEDCOMPLETEPENDINGPROCESSING

taskIdstring

ID of the task.

json
{
  "completedAt": "2025-01-01T00:00:00Z",
  "startedAt": "2025-01-01T00:00:00Z",
  "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": 0,
  "requestedAt": "2025-01-01T00:00:00Z",
  "result": {
    "archived": false,
    "createdAt": "2025-01-01T00:00:00Z",
    "id": "string",
    "updatedAt": "2025-01-01T00:00:00Z",
    "archivedAt": "2025-01-01T00:00:00Z",
    "name": "string",
    "parentFolderId": "string",
    "path": "string"
  }
}

Need more? See the HubSpot guide for connection setup and behaviour shared by every action.