POST
, PUT
, and PATCH
operations. An idempotent request can be retried multiple times without the risk of performing the same operation more than once.
Idempotent requests
To perform an idempotent request, provide an additionalIdempotency-Key
header with a unique key. If you don’t receive a response due to a network connection error, you can retry the request with the same key to guarantee that it is only performed once.
Generating idempotency keys
We recommend usingV4
UUIDs, or any other random string with enough randomness to avoid collisions. Keys can be up to 256
characters long.