Deduplicate retryable create requests.
Section: Idempotency patterns
Use an idempotency key for POST
http
http
POST /payments
Idempotency-Key: 8f3dc9d4-7d3e-4c66-9f44-7d85f0f86dd1Explanation
This pattern helps clients safely retry network-failed POST requests without creating duplicate side effects.
Learn the surrounding workflow
Compare similar commands or jump into common fixes when this command is part of a bigger troubleshooting path.
Related commands
Same sheet · prioritizing Idempotency patterns
Client-chosen resource ID via PUT
Make resource creation naturally idempotent.
Avoid mutations on GET
Do not track writes in the same endpoint contract.
POST creates or triggers processing
Submit a new resource or command-like workflow.