ValidationError

Represents a coded business error, delivered under extensions.error of a GraphQL error. The client resolves its own wording from errorCode and fills placeholders from params; message is the backend's log-oriented text and is not shown to users.

type ValidationError implements APIError {
  errorCode: ErrorCode!
  message: String!
  params: JSON
}

Fields

ValidationError.errorCode ● ErrorCode! non-null enum

Error code identifying this validation error

ValidationError.message ● String! non-null scalar

Human-readable error message describing the validation failure

ValidationError.params ● JSON scalar

Named values for the client's copy to interpolate, e.g. {"employeeName": "Maria Schmidt", "date": "2026-03-14"}. Absent when the error carries none — never null, never {}.

Keys are named lowerCamelCase identifiers (employeeName), never positional (0): German word order differs from English and translators reorder placeholders. Values are raw and unformatted — ISO dates, plain decimals — because formatting is the client's job. A parameter is a discrete value, never message text: no catch-all message/text key and no sentences. The backend rejects both at the throw site.

Interfaces

APIError interface

Interface for API errors