Validation Error
validation_errorinputWhat happened
The request does not satisfy the operation contract or conflicts with an earlier request.
Possible causes
- A required field, format, range, or idempotency value is invalid.conditional
- The request body was built against a different contract version.conditional
Check in this order
- Verify the response evidenceread-only
Compare the request with the current schema and inspect the structured validation issues.
error.code · HTTP status · request_id · X-Trace-Id
Safe recovery
Correct the cause before retryingmutation
Correct only the rejected fields, preserve the intended idempotency identity, and submit a new validated request.
Retry: Not before correctionSuccess evidence
- A new response satisfies the documented success contract.
Stop condition
Do not retry until the diagnostic check identifies a corrected input or configuration.
Verification evidence
Contractverifiedcontract-derivedSynthetic recoverynot-applicablecontract-derivedRead-only staging canarynot-applicablecontract-derivedProduction observationno-evidencecontract-derived