Skip to main content
POST
Router Select

Authorizations

Authorization
string
header
required

Enter your MeshAPI key (rsk_...) or, for the admin-keys endpoints, a dashboard session token — sent as Authorization: Bearer <token>.

Headers

X-Mesh-Version
enum<string>
default:2026-08

Dated version of the API contract to pin this request to. Omit it and the request is served under 2026-08 — the oldest supported version, so an existing integration is never moved by a release. A malformed or unsupported value is rejected with 400 invalid_api_version rather than falling back silently. The version actually served is echoed as X-Mesh-Version on every response, including errors.

Available options:
2026-08,
2026-09

Body

application/json
messages
Message · object[]
required
Minimum array length: 1
api_type
enum<string>
default:completions
Available options:
completions,
responses,
embeddings
exclude_models
string[] | null
candidate_models
string[] | null
router_version
string | null
tags
Tags · object | null

Your own labels for this request, echoed back on the usage row and available as a filter and a group-by dimension in the usage API. String keys to string values. Never put personal or sensitive data here — tags are stored with the usage record and are not redacted.

Example:

Response

Successful Response

model
string
required
auto_router
AutoRouterMeta · object
required
reasoning_effort
enum<string> | null
Available options:
high,
medium,
low,
none