{
  "topic": "errors.VALIDATION_FAILED",
  "path": [
    "errors",
    "VALIDATION_FAILED"
  ],
  "title": "VALIDATION_FAILED — payload fails model schema validation",
  "synopsis": "Unlike `BAD_REQUEST` (which covers parse failures), this error is returned when the payload is parseable but violates the registered model schema — for example, a required field is missing, a value is out of the allowed range, or a workflow guard condition is not satisfied. The error detail includes the specific validation failure.",
  "body": "# errors.VALIDATION_FAILED\n\n## NAME\n\nVALIDATION_FAILED — the request payload is structurally valid JSON but fails the model's schema or workflow validation rules.\n\n## SYNOPSIS\n\nHTTP: `400` `Bad Request`. Retryable: `no`.\n\n## DESCRIPTION\n\nUnlike `BAD_REQUEST` (which covers parse failures), this error is returned when the payload is parseable but violates the registered model schema — for example, a required field is missing, a value is out of the allowed range, or a workflow guard condition is not satisfied. The error detail includes the specific validation failure.\n\nCorrect the payload according to the model's schema constraints. Review the model definition for required fields, type constraints, and workflow guard conditions.\n\n## SEE ALSO\n\n- errors\n- errors.BAD_REQUEST\n- errors.POLYMORPHIC_SLOT\n",
  "sections": [
    {
      "name": "NAME",
      "body": "VALIDATION_FAILED — the request payload is structurally valid JSON but fails the model's schema or workflow validation rules."
    },
    {
      "name": "SYNOPSIS",
      "body": "HTTP: `400` `Bad Request`. Retryable: `no`."
    },
    {
      "name": "DESCRIPTION",
      "body": "Unlike `BAD_REQUEST` (which covers parse failures), this error is returned when the payload is parseable but violates the registered model schema — for example, a required field is missing, a value is out of the allowed range, or a workflow guard condition is not satisfied. The error detail includes the specific validation failure.\n\nCorrect the payload according to the model's schema constraints. Review the model definition for required fields, type constraints, and workflow guard conditions."
    },
    {
      "name": "SEE ALSO",
      "body": "- errors\n- errors.BAD_REQUEST\n- errors.POLYMORPHIC_SLOT"
    }
  ],
  "see_also": [
    "errors",
    "errors.BAD_REQUEST",
    "errors.POLYMORPHIC_SLOT"
  ],
  "stability": "stable",
  "actions": []
}