Idempotency | KuikCode Docs

Send an Idempotency-Key on POST requests so a retry after a timeout never creates the same thing twice.

Networks fail after the request was processed. To make retries safe, send an Idempotency-Key header on any POST:

curl -X POST https://api.kuikcode.com/v1/codes \
  -H "Authorization: Bearer kc_live_..." \
  -H "Idempotency-Key: order-8812-code" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Order 8812", "destination": { "type": "url", "url": "https://example.com/o/8812" } }'

The key is any string up to 255 characters that is unique per operation on your side: an order id, a UUID, a database row id.
A successful response is stored for 24 hours per API key. Repeating the request with the same key within that time returns the stored response with the header Idempotent-Replayed: true and creates nothing new.
Only successful responses are stored. A failed request can be retried with the same key.
Keys are scoped to the API key that sent them.

PATCH and DELETE are naturally repeatable and ignore the header.