---
title: "Admin Routing Preview"
method: POST
path: "/v1/ai-models/admin/routing-preview"
tags: ["ai-models"]
---

# Admin Routing Preview

`POST /v1/ai-models/admin/routing-preview`

## Request body

- RoutingPreviewRequest
  - `request` RoutingPreviewInput, required
    - `model` 'auto' | 'cheshir' | 'kodik-flash' | 'kodik-pro' | 'kodik-max', required
    - `stream` boolean
    - `reasoning_effort` string, nullable
    - `reasoning_mode` string, nullable
    - `temperature` number, nullable
    - `top_p` number, nullable
    - `input` union, required
      - string
      - object[]
    - `reasoning` object, nullable
    - `store` false
    - `background` false
    - `previous_response_id` unknown
    - `conversation` unknown
    - `max_output_tokens` integer, nullable
  - `premium_eligible` boolean

## Response `200`

Successful Response

- RoutingPreviewResponse
  - `requested_model` string, required
  - `start_tier` string, required
  - `selected_tier` string, nullable
  - `selected_model` string, nullable
  - `status` 'selected' | 'unavailable', required
  - `router_version` integer, required
  - `evaluator_version` string, required
  - `policy_fingerprint` string, required
  - `classification_score` number, nullable
  - `reasons` string[], required
  - `request_features` object, required
  - `estimated_input_tokens` integer, required
  - `estimated_output_tokens` integer, required
  - `required_context_tokens` integer, required
  - `premium_eligible` boolean, nullable, required
  - `weights` object, required
  - `max_quality_shortlist_delta` number, nullable
  - `candidates` RoutingCandidateDiagnostic[], required
    - `tier` string, required
    - `model_id` string, required
    - `pool_position` integer, required
    - `eligible` boolean, required
    - `selected` boolean
    - `exclusions` string[]
    - `profile_revision` integer, nullable
    - `profile_source` string, nullable
    - `profile_match` number, nullable
    - `match_reasons` string[]
    - `quality_score` number, nullable
    - `cost_score` number, nullable
    - `cost_value` number, nullable
    - `cost_basis` 'estimated_usd' | 'multiplier', nullable
    - `selection_score` number, nullable
    - `shortlisted` boolean
    - `context_window` integer, nullable
    - `warnings` string[]
  - `warnings` string[]
  - `decision_id` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-10-02** `650f7a88fb5e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/kodik/apis/kodik-api/changes/v1/ai-models/admin/routing-preview/post.md)

---

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