Advanced

Retrieve status

Retrieve the status of an asynchronous file import task using the task ID. This endpoint provides information about the current state of the task, such as whether it is pending, processing, canceled, or complete.

get/files/2026-09-beta/files/import-from-url/async/tasks/{taskId}/status

Path parameters

taskIdstring required

The ID of the asynchronous file import task.

Response

successful operation

completedAtstring date-time required

The date and time when the file action was completed, in ISO 8601 format.

linksobject

A map of link names to associated URIs, providing additional information about the file action.

numErrorsinteger

The number of errors encountered during the file action, represented as an integer.

requestedAtstring date-time

The date and time when the file action was requested, in ISO 8601 format.

startedAtstring date-time required

The date and time when the file action started, in ISO 8601 format.

status'CANCELED' | 'COMPLETE' | 'PENDING' | 'PROCESSING' required

The current status of the file action. Valid values include 'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'.

taskIdstring required

The unique identifier for the task associated with the file action.