Idempotency
Networks fail mid-request. An Idempotency-Key lets you retry a request safely without doing the work twice.
retry-safely
curl --request POST https://api.warka-iq.com/v1/capture-sessions \
--header "Authorization: Bearer $WARKA_KEY" \
--header "Idempotency-Key: 8f14e45f-attendance-7731" \
--header "Content-Type: application/json" \
--data '{"identity_id": "idn_..."}'- Supported on enrollment, capture session creation and verify.
- A repeat replays the first response and sets Idempotency-Replayed: true.
- The same key with a different body returns 422 idempotency_key_reused.
- A request that failed releases its key, so a retry runs normally. Keys last 24 hours.