---
title: "Flash JEV typed decisions"
method: POST
path: "/decisions/flash-jev"
---

# Flash JEV typed decisions

`POST /decisions/flash-jev`

## Request

- Base URL: `https://api.openmayhem.ai/v1`
- URL: `https://api.openmayhem.ai/v1/decisions/flash-jev`
- Auth: HTTP bearer

Requires the DECISIONS scope. Uses openmayhem/flash-jev, a platform-side typed-decision view of the canonical Qwen3.8 Flash-Next chat model. The request is charged at Flash-Next's current input and output token rates; there is no separate tariff. It asks Flash for probabilities in strict JSON and applies the same mechanical validation, bounded normalization (sum error at most 0.051), lexical tie break, weighted score, and request-sourced score legend used in the published evaluation. Confidence is a deterministic concentration display, not an independently calibrated forecast. No label-specific correction is applied. Invalid outputs return 502 after the signed model usage is charged; do not retry an ambiguous outcome as new work. Maximum input is 64,000 exact model tokens across state and questions, and 32,000 for state plus any single question. At most 64 named questions. The decision result is synchronous and does not stream.

## Headers

- `X-Mayhem-Min-Att-Tier` union
  - integer
  - 'T1' | 'T2' | 'T3' | 'T4'
- `X-Mayhem-Min-Ctx` integer
- `X-Mayhem-Quant` string
- `X-Mayhem-Prefer-Providers` string
- `X-Mayhem-Hedge` 0 | 1
- `X-Mayhem-Min-Tok-S` number
- `X-Mayhem-Max-Wait-Ms` integer
- `X-OpenMayhem-Max-Cost-Usd` string: Non-negative decimal USD string with at most 6 decimal places, parsed with exact fixed-point arithmetic.
- `X-OpenMayhem-Max-Input-Price-Per-Million-Usd` string: Non-negative decimal USD string with at most 6 decimal places, parsed with exact fixed-point arithmetic.
- `X-OpenMayhem-Max-Output-Price-Per-Million-Usd` string: Non-negative decimal USD string with at most 6 decimal places, parsed with exact fixed-point arithmetic.
- `X-OpenMayhem-Max-Representative-Request-Price-Usd` string: Non-negative decimal USD string with at most 6 decimal places, parsed with exact fixed-point arithmetic.
- `X-OpenMayhem-Estimate` string

## Request body

- object
  - `model` 'openmayhem/flash-jev', required
  - `state` union, required
    - string
    - object
  - `questions` object, required: Map of question IDs to {type, instructions, criteria?}. type is noul, choice or score; choice criteria maps labels to descriptions, and score criteria is an ordered description array.

## Response `200`

decision.result with named, validated decisions; usage.cost and signed receipt evidence.

## Other responses

- `400`: Contract violation; nothing charged.
- `401`: Missing or invalid API key.
- `402`: Insufficient credit.
- `403`: Scope, allowlist, spend limit or account restriction.
- `413`: The exact model tokenizer found an input above the 64k total or 32k per-question limit; nothing charged.
- `429`: Rate limit; wait Retry-After seconds.
- `502`: The model produced invalid decision JSON or probabilities; signed usage may still be charged.
- `503`: No provider capacity; retry with backoff.

---

[API](https://skmtc.dev/openmayhem/apis/openmayhem-api.md) · [All operations](https://skmtc.dev/openmayhem/apis/openmayhem-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openmayhem/apis/openmayhem-api/revisions/0ea33ad12f21?raw)