validation-failed

Description

The request body, query parameters, path variables, or headers failed validation. The response includes an errors array that describes each violation, including its scope, field path, a machine-readable code string, and a human-readable message.

Response Example

Code
{
  "type": "https://docs.kordiam.app/docs/errors/validation-failed",
  "title": "Validation Failed",
  "status": 400,
  "detail": "Validation failed. Check the 'errors' array for details.",
  "instance": "/api/v2/platforms/0",
  "traceId": "abc-123-def",
  "errors": [
    {
      "scope": "path",
      "path": "id",
      "code": "range",
      "message": "must be greater than or equal to 1"
    }
  ]
}

Common Causes

• Missing required fields in the request body
• Field values exceeding maximum size limits
• Invalid enum values that do not match the expected set
• Numeric fields with values outside the allowed range

How to Fix

1. Inspect the errors array in the response. Each entry tells you which field failed validation (path), where it is located (scope), and what went wrong (code and message).
2. Correct the identified fields and retry the request.