Skip to content
aityx
Esc
↑↓navigate↵open⌘Jpreview
On this page

Errors

Handle schema errors, missing facts and completed Jev with a model failure.

Failed requests return problem details (application/problem+json) with a stable code. Validation problems can include errors, each with a path and message.

{
  "status": 422,
  "code": "invalid_state",
  "detail": "State does not match the decision inputs.",
  "errors": [{ "path": "state.customer_intent", "message": "missing input" }]
}
Status / code Meaning Next step
400 invalid_request Malformed body or unsupported fields. Use the current native payload and one top-level state.
401 unauthorized Missing, expired, invalid or revoked credentials. Check your API key in the console.
403 access_disabled Access for this email was disabled. Contact [email protected].
402 insufficient_balance Jev calls require a positive balance; Decision-only calls require funds for the full reservation. Check Usage; contact the preview team for credits.
422 invalid_state Facts do not match the model schema. Nothing extracts facts for you. Supply matching facts, or add Jev questions that establish them.
422 invalid_model The supplied model failed validation. Fix its definition or use the console’s free Check.
422 evaluation_failed The model could not evaluate these inputs. Read the details and check expressions and types.
502 jev_failed or invalid_jev_response Jev failed or returned unusable results. Read the problem detail; the native model did not run.
503 jev_unavailable Jev execution is unavailable. Retry later or use matching native facts when available.
504 jev_timeout Jev timed out. Retry with backoff; inspect the detail.
500 internal_error An unexpected service failure. Retry with backoff; report the request identifier if available.

HTTP 200 can still mean partial failure

If Jev completes but the following native model fails, the completed Jev result is preserved:

{
  "decision_error": {
    "code": "invalid_state",
    "detail": "State does not match the decision inputs."
  }
}

This is an error-field excerpt. The full public response includes Jev’s answers, receipt, usage and decision_error; it does not include execution status or billing metadata. The completed Jev operation is charged once at the single rate.

if (response.decision_error) {
  // Keep response.answers and response.receipt; inspect decision_error.
  // Native answers are not available; do not act on them.
}

Always check both the HTTP status and decision_error for combined calls. Other failed operations release their credit reservation; review settled charges in the console.

Model checks and replay are console/internal operations; there is no public validation or model-authoring route. See Pricing and limits.

Was this page helpful?