Create Routing Policy
Create an organization routing policy. Clients use it by sending its
model (@alias/<slug>) as the model. The organization’s first policy
becomes the default automatically; otherwise send is_default true to make
it the default. Needs a management key.
Authentication
A management key (mgmt_...), sent as Authorization: Bearer <key>. Reading /v1/routing-policies also accepts the organization’s gateway API keys; writing there needs a management key.
Request
PRIORITY tries priority_order in turn; INTELLIGENT picks among allowed_models per request, optimizing for axis.
INTELLIGENT only, optional. Not stored: responses rebuild it from allowed_models. If sent non-empty, it must name the same providers as allowed_models (order and repeats don’t matter), or the request fails with 422.
INTELLIGENT only. What the router optimizes for: COST, PERFORMANCE or CAPABILITY. Omitted or null means COST.
The id of a classifier from /v1/classifiers. An INTELLIGENT policy then judges how complex each request is with your classifier instead of the built-in scorer. An unknown classifier, or one without 3 examples on each side, is a 400. INTELLIGENT only.
INTELLIGENT only. How the router trades cost for speed: SAVE_COST picks the cheapest model likely to succeed, BALANCED pays more when the time saved justifies it, PREFER_SPEED favors faster models at higher cost. Omitted or null means SAVE_COST. BALANCED and PREFER_SPEED need cost and speed presets enabled for the organization.
PRIORITY only. The priority values are kept as sent; responses list the entries sorted by priority. A model listed twice is a 422.
The policy’s model alias, as a lowercase bare name. Omitted: derived from the name, or “default” when the policy becomes the organization default. A taken alias gets a suffix (“fast”, “fast-2”).
Vendor tiers for this policy’s requests, replacing the organization’s. Same shape and rules as the organization’s vendor_priority. Omitted or null means none.
Response
INTELLIGENT only. The providers of allowed_models, sorted. Always rebuilt from allowed_models; never stored.
INTELLIGENT only, else null. What the router optimizes for: COST, PERFORMANCE or CAPABILITY.
The ready-to-send model string for this policy, like “@alias/fast-experiment”. Send it as the model in any gateway request to route with this policy.
The policy’s model alias as a bare name, like “fast-experiment”. Null only when no alias could be made, such as an organization at its alias limit.
PRIORITY tries priority_order in turn; INTELLIGENT picks among allowed_models per request, optimizing for axis.
The id of a classifier from /v1/classifiers. An INTELLIGENT policy then judges how complex each request is with your classifier instead of the built-in scorer. An unknown classifier, or one without 3 examples on each side, is a 400. null when the policy uses the built-in scorer.
INTELLIGENT only. How the router trades cost for speed: SAVE_COST, BALANCED or PREFER_SPEED.