428

API problem detail

Precondition Required

Description

This problem happens when a required If-Match header was omitted from an ETag-guarded replacement, such as the branch bank-account PUT /Branch/{branchId}/BankAccounts. The replacement is all-or-nothing, so the API refuses to apply it without knowing which version you read.

The permission replacement PUT /User/{userId}/Permissions reports a missing or * If-Match differently: as a Preflight 400 with the validation failure "A specific ETag is required."

Response errorCode: PRECONDITION_REQUIRED.

Experience API error bodies also carry errorCode, resolution, and traceId. Branch on errorCode, not on title or detail; see fields on every error.

How to resolve

GET the document first, retain the response's ETag, and retry the PUT with that value in If-Match plus a fresh X-Idempotency-Key.
Back to all problem details