Favor deterministic patches.
Section: Idempotency patterns
Use set-style PATCH operations
json
json
{
"display_name": "Jane Smith",
"timezone": "America/Los_Angeles"
}Explanation
Field assignment patches are easier to reason about than increment-style or append-style patches when idempotency matters.
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.