validation_failed

HTTP 422: Validation failed

When it occurs

The request body fails schema validation: a required field is missing, a value is the wrong type, or a value falls outside a field's declared range. The errors extension array names every failing field with its own detail (ERR-01), so a multi-field failure is one response, not several round trips.

This is not what happens to an out-of-registry enum or modality value. PRIN-02 lets this platform add optional fields and enum values over time. PRIN-03 defines a fallback for every enum, so a consumer that hasn't caught up stays correct:

• modality code: falls back to other
• technique: falls back to null
• duplicate-cluster confidence: falls back to medium
• person status: falls back to active
• grant state: falls back to revoked

Send and receive these values as-is. Only a structural violation returns validation_failed.

What to do next

Read every entry in errors and fix each named field. If nothing in errors names the field you suspect, the value you sent was tolerated, not rejected; check the fallback it resolved to instead.