REST API Methods and Idempotency/Use an idempotency key for POST

Deduplicate retryable create requests.

Section: Idempotency patterns

Use an idempotency key for POST

http
http
POST /payments
Idempotency-Key: 8f3dc9d4-7d3e-4c66-9f44-7d85f0f86dd1
Explanation

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.
OpenIn sheethttpsame section
Use set-style PATCH operations
Favor deterministic patches.
OpenIn sheetjsonsame section
Avoid mutations on GET
Do not track writes in the same endpoint contract.
OpenIn sheettextsame section
POST creates or triggers processing
Submit a new resource or command-like workflow.
OpenIn sheethttp1 tag match
GET retrieves data
Read without changing server state.
PUT replaces state
Send a full replacement representation.