ProblemDetailDto

  • A human-readable explanation specific to this occurrence of the problem. May include the offending parameter value and the list of accepted values to help the caller recover.

  • A short, human-readable summary of the problem type. Stable for a given type (e.g. Invalid Sort Property for ANL_00422, Token Expired for ANL_00498) but not intended for programmatic branching — use type for that.

  • A machine-readable error code identifying the problem type.

    • ANL_00401 — the clientId is unknown, the clientSecret is incorrect, or the JWT is missing, malformed, or failed verification (HTTP 401)

    • ANL_00403 — the credentials or JWT are valid, but access is not permitted: the client is disabled, has no accessible instances, or the requested instanceIds are not bound to it (HTTP 403)

    • ANL_00498 — the JWT has expired; request a new token via /oauth/token (HTTP 401)

    • ANL_00400 — one or more query parameters failed validation (HTTP 400)

    • ANL_00422 — the sortProperty value is not supported for this endpoint, or is not available for the selected platform / contentType filter (HTTP 400)

    • ANL_00404 — the requested resource could not be found (HTTP 404)

    • ANL_00415 — the request Content-Type is not supported; use application/json (HTTP 415)

    • ANL_00500 — an unexpected server-side error occurred; the request was not processed and the credentials are not implicated, so retry with exponential backoff (HTTP 500)

    values
    ANL_00400ANL_00401ANL_00498ANL_00403ANL_00422ANL_00500ANL_00404ANL_00415