Fetches the status and result of a job executed in the background.
Any of Scrivito’s API requests may be executed in the background. The response to such a request is a task response delivering a task ID. Use the task API for polling the task status. Once the background job is done, the task status contains the result of the initial action.
Params
tenant_id – The ID of the tenant.task_id – The ID of the task.Response
The task status. If the task succeeded, the response also includes a result, i.e. what the initial action would have returned had it been synchronous, e.g. the representation of the working copy that was created. If the task failed, the response includes error details.
Example
Example of the initial response for an API call being performed in the background, e.g. a working copy creation request:
Get the task status:
Response for a running task:
Response for a finished task – the result includes data about the created working copy:
Response for a failed task: