Evaluate typed decisions
POST/v1/decisions
Evaluate named noul, choice, or score questions against shared state.
Authenticate with a MindsHub key. TypeSafe hosts Jev; no TypeSafe key is needed by callers. Each question sees the same state and returns an answer under its original name. The response model is the actual served version.
Returns one JSON response; streaming, tools, and conversation chaining are not supported. Input and output are priced at $0 during the Jev launch promotion. Organizations with wallet credit, or with a card that has completed a top-up and has no payment error, call Jev without a daily cap. Other organizations get a free daily allowance while shared free capacity lasts; past it the request is refused with 402 wallet_empty. Rate limits apply to every organization.
Allowance: https://docs.mindshub.ai/inference/billing#jev-decisions Guide: https://docs.mindshub.ai/inference/decision-models Examples, limits, and retries: https://docs.mindshub.ai/inference/decisions
Request
Responses
- 200
- 400
- 401
- 402
- 403
- 404
- 422
- 429
- 503
- 529
Successful Response
Wrong model kind, unavailable provider configuration, or provider validation failure.
Missing or invalid MindsHub credentials.
The organization has neither wallet credit nor a card with a completed top-up and no payment error, and its free daily allowance is used up or shared free capacity has run out (wallet_empty). Add credit to lift the cap; X-MindsHub-Recovery-Url carries the console path. Allowance: https://docs.mindshub.ai/inference/billing#jev-decisions
Response Headers
Machine-readable denial reason (permission_denied, rate_limited, included_allowance_exhausted, free_air_daily_spend_fuse_exceeded, wallet_empty).
Relative console URL where credit can be added.
The credential does not have permission to run this model.
Model alias unavailable in this environment or to this account.
Validation Error
Rate limit. Honor Retry-After when supplied.
MindsHub could not verify the access policy, or the provider failed. upstream_status: 502 marks a provider connection, credential, or response failure, after which an evaluation may already have run. upstream_status: 504 marks a provider timeout, and resending may execute a duplicate evaluation.
Provider overload. Honor Retry-After when supplied.