notesField note

On idempotency in distributed systems

Apr 20, 2026#backend#platform

Idempotency is the cheapest insurance you can buy for a distributed system. Every external write — payment, email, webhook — should accept an idempotency key. Every retry should reuse it.

When clients can't generate a stable key, generate one server-side from the request shape and a short window. Worse than a duplicate is a duplicate you can't explain.