Idempotent Requests

We support idempotency for any POST request to the API.

How to use it

To make an idempotent POST request, provide an additional Idempotency-Key: <key> header to the request.

The idempotency <key> should be a unique value. A good example of such a key is generated UUID.

How it works

We save the resulting status code and body of the first request made for any given idempotency key, regardless of whether it succeeded or failed for 24 hours.

Subsequent requests with the same key return the same result, including any 400 or 500 errors, until the first (stored) request is invalidated (after 24 hours).

When the idempotency key is invalidated, the upcoming request with the same key will be stored again.