Asynchronous Endpoints
Last updated
Was this helpful?
Last updated
Was this helpful?
All long-running operations we offer through the API are exposed in an asynchronous manner. What this means is that these operations will generally require this query pattern on your part:
Initiate the task, usually at a /new
endpoint, which gives you a task id
Query a nearby /status
endpoint with that task ID to get the current status of the task. The statuses can be any of the following.
SUBMITTED
: We have received your request but have not yet started working on it.
IN_PROGRESS
: A worker is actively processing your request.
SUCCEEDED
: Your request has been completed. A metadata field will be attached providing the location of the finished result, which you can generally issue a GET
request to retrieve.
FAILED
: Your request failed. A metadata field will be attached with a reason why, which can often be helpful in order to determine a fix and resubmit.
For a good example of an asynchronous endpoint, check out the .