Skip to main content
Use idempotency keys when retrying create or money-moving POST requests. If your first request times out, retry with the same key and the same body.

How it works

  1. Send a stable Idempotency-Key for one business operation.
  2. Reuse that key only when retrying the same request.
  3. If the original request completed, Ionic returns the original result.
  4. If the same key is reused with a different body or endpoint, Ionic rejects the request.
Replayed responses include:

Conflict behavior

Key design

Use a key derived from your own operation ID, not a random key generated per retry. Good:
Avoid: