Decoupled responses

For requests are taking longer to return than expected, the default behaviour of the API service is to return a "decoupled response".

This takes the form of a 202 Accepted response, containing a Location header for where to check for the result.
An X-Delay response header shows the current number of milliseconds that the next check must wait for at the minimum. This number can change between checks.

In order to force the service to block the initial response until a result is available, the X-PreventDecouple: true request header can be sent.

Example: Default decoupled response

250ms delay

Example: Blocking response

Wait