Problem

Schema #/components/schemas/Problem of contract 1.0.0-draft.14.

  • type string (uri)required

    URI identifying the problem type. Documented at the URI. about:blank is never used.

  • title stringrequired

    Short, stable summary of the problem type.

  • status integerrequired

    HTTP status code.

    min 400 · max 599

  • detail string

    Occurrence-specific explanation. Never contains secrets or internal identifiers of other tenants.

  • instance string (uri-reference)

    URI reference identifying this occurrence (the request path plus request id).

  • errors array of FieldError

    Field-level validation errors (present for 400/422).

  • requestId stringrequired

    Value of X-Request-Id for this request; quote it to support.

  • code string

    Stable machine-readable problem code (last path segment of type).

  • retryAfterSeconds integer

    For 409 idempotency-in-progress and 429 responses.

    min 0

  • stepUp object

    Present when type is .../step-up-required.

    Fields of stepUp
  • reason string

    401 session-expired only: why the session ended. idle: the idle limit (30 min staff, 60 min customers on the web); revoked: signed out, failed step-ups or a staff action; expired: absolute lifetime reached (mobile: refresh the access token, then sign in again if that fails).

    One of: "idle", "revoked", "expired"