Console
Docs/Core concepts

Idempotency

How a retry becomes a replay instead of a second charge.

#The three outcomes

Every write accepts Idempotency-Key.

  • Same key and same body: the first response is replayed, including the resource id.
  • Same key, different body: 409 idempotency_conflict.
  • Same key while the first request is still running: 409 request_in_progress, retry shortly.

Use a key derived from your own operation (order id plus attempt), not a random value per retry.

Reference

Every route, parameter and response is generated from the OpenAPI 3.1 document.

Open the API reference