vitna.ai/docs/api/v1/engine/router-challenge Machine view
Raw .md llms.txt
> Source: https://vitna.ai/docs/api/v1/engine/router-challenge
> Raw Markdown: https://vitna.ai/docs/api/v1/engine/router-challenge.md
> Corpus index: https://vitna.ai/llms.txt

# Router challenge

Evaluate in memory whether handing model selection to a dynamic router (`openrouter/auto`, `martian/model-router`, `notdiamond/custom-router`, `routellm/mf`, or a custom router) beats naming a fixed [SKU](../../../concepts/sku.md), with zero retention. The HTTP surface for [Router Challenge (#72)](../../../routing/router-challenge.md).

```
POST /api/v1/router-challenge
```

```bash
curl -X POST https://vitna.ai/api/v1/router-challenge \
  -H "Content-Type: application/json" \
  -d '{
    "workload": {
      "id": "acme/support-triage",
      "name": "Support triage",
      "unitLabel": "tickets",
      "constraints": {
        "qualityFloor": 88.0,
        "economicThresholdPct": 15.0,
        "edgeCaseVeto": ["pii_redaction"]
      }
    },
    "incumbent": {
      "skuId": "openai/gpt-5.6-luna",
      "name": "GPT-5.6 Luna",
      "unitCostUsd": 0.03,
      "successRatePct": 90.0,
      "latencyP90Ms": 1200
    },
    "router": {
      "skuId": "martian/model-router",
      "surchargePerRequestUsd": 0.004
    },
    "observations": [
      { "units": 500, "tokenSpendUsd": 7.50, "latencyP50Ms": 450 }
    ],
    "routerEvidence": {
      "successRatePct": 92.0,
      "n": 500,
      "latencyP90Ms": 1400,
      "edgeCaseFailures": []
    }
  }'
```

## Response

```json
{
  "status": "evaluated",
  "workloadId": "acme/support-triage",
  "workloadName": "Support triage",
  "routerSkuId": "martian/model-router",
  "routerName": "Martian Model Router",
  "outcome": "switch",
  "reason": "Martian Model Router beats incumbent GPT-5.6 Luna by 31.1% on cost per successful unit while meeting the 88.0% quality floor.",
  "checks": [
    {
      "name": "quality floor",
      "threshold": "88.0%",
      "observed": "92.0%",
      "passed": true
    }
  ],
  "knownRouters": { ... },
  "meta": {
    "generatedAt": "2026-09-12T09:14:02.881Z",
    "minRequiredUnits": 20
  }
}
```

## Epistemic refusal below 20 units

A dynamic router publishes no static per-token list price, so its effective unit cost is derived from observed trial telemetry plus any per-request or percentage routing fee. When `observations` sum to fewer than `20` units, the endpoint returns `200` with `status: "refused"`, `outcome: "stay"`, and the exact observation shortfall rather than extrapolating from a handful of prompts.

## Zero retention

Payloads are evaluated strictly in memory and are never written to the database, disk, or application logs.

## Caching

`no-store`.
Human Machine Shift+M