×

You're using an outdated browser

For a better experience, keep your browser up to date. Check here for the latest version.

Manual

Asynchronous Tasks

Matthias Gaiser

Matthias Gaiser Last update: Aug 4, 2017

Info

Please make sure to read the Introduction to the REST API before starting to use it.

This page describes all rest endpoints which are related to asynchronous tasks. Asynchronous tasks are used in various endpoints of our REST API in order to start long-running tasks in Backbone. This resource can be used in order to get the status of these tasks and the result.

MethodURLDescription
GET/async-tasks/{taskId}Returns status information about the asynchronous task. If finished, it also includes the result.


Detailed description

 Get Status

GET /async-tasks/{taskId}

Returns status information about the asynchronous task. If finished, it also includes the result.

URL ParameterDescriptionDefaultRequired
taskIdThe task id of the asynchronous task. This is returned by the endpoints which start an asynchronous task.-(tick)

Example Response

The endpoint will return an object containing the details about the asynchronous task.

{
    "id": "53A90124015DAC398C292BBD70979338",
    "completionTimestamp": "Aug 04, 2017 -- 09:51 AM",
    "startTimestamp": "Aug 04, 2017 -- 09:51 AM",
    "result": true,
    "finished": true,
    "cancelled": false,
    "hasFailed": false,
    "failureMessage": null,
    "progress": 0,
    "message": "Successfully stopped the integration.",
    "resourceLocation": null
}
2x3.6
We use cookies to create a secure and effective browsing experience for our website visitors and to understand how you use our site (i.e. Google Analytics). For more information: click here.
Ok