younifyd
Menu

Get /files/v3/files/import From Url/async/tasks/{task Id}/status Check Import

Check import status

GET/files/v3/files/import-from-url/async/tasks/{taskId}/status

Use it in a workflow

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

Request

Path parameters

taskIdstringrequired

Import by URL task ID

Response

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

completedAtstring (date-time)

Time of completion of task.

errorsarray<object>

Descriptive error messages.

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 requested task.

numErrorsinteger (int32)

Number of errors resulting from the task.

requestedAtstring (date-time)

Timestamp of when the task was requested.

resultobject

File

accessstringrequired

File access. Can be PUBLIC_INDEXABLE, PUBLIC_NOT_INDEXABLE, PRIVATE.

One ofHIDDEN_INDEXABLEHIDDEN_NOT_INDEXABLEHIDDEN_PRIVATEHIDDEN_SENSITIVEPRIVATEPUBLIC_INDEXABLEPUBLIC_NOT_INDEXABLESENSITIVE

archivedbooleanrequired

If the file is deleted.

archivedAtstring (date-time)

Deletion time of the file object.

createdAtstring (date-time)required

Creation time of the file object.

defaultHostingUrlstring

Default hosting URL of the file. This will use one of HubSpot's provided URLs to serve the file.

encodingstring

Encoding of the file.

expiresAtinteger (int64)
extensionstring

Extension of the file. ex: .jpg, .png, .gif, .pdf, etc.

fileMd5string

The MD5 hash of the file.

heightinteger (int32)

For image and video files, the height of the content.

idstringrequired

File ID.

isUsableInContentboolean

Previously "archied". Indicates if the file should be used when creating new content like web pages.

namestring

Name of the file.

parentFolderIdstring

ID of the folder the file is in.

pathstring

Path of the file in the file manager.

sizeinteger (int64)

Size of the file in bytes.

sourceGroupstring

One ofCONTENTCONVERSATIONSFORMSUI_EXTENSIONSUNKNOWN

typestring

Type of the file. Can be IMG, DOCUMENT, AUDIO, MOVIE, or OTHER.

updatedAtstring (date-time)required

Timestamp of the latest update to the file.

urlstring

URL of the given file. This URL can change depending on the domain settings of the account. Will use the select file hosting domain.

widthinteger (int32)

For image and video files, the width of the content.

startedAtstring (date-time)

Timestamp of when the task was started.

statusstring

Current status of the task.

One ofCANCELEDCOMPLETEPENDINGPROCESSING

taskIdstring

ID of the requested 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": {
    "access": "HIDDEN_INDEXABLE",
    "archived": false,
    "createdAt": "2025-01-01T00:00:00Z",
    "id": "string",
    "updatedAt": "2025-01-01T00:00:00Z",
    "archivedAt": "2025-01-01T00:00:00Z",
    "defaultHostingUrl": "string",
    "encoding": "string",
    "expiresAt": 0,
    "extension": "string",
    "fileMd5": "string",
    "height": 0
  }
}

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