Skip to navigation

Set Default Routing Policy

Make this policy the organization's default, unsetting the previous default. Needs a management key.

Authentication

AuthorizationBearer

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.

Path parameters

policy_idstringRequiredformat: "uuid"

The policy’s id.

Response

The routing policy, now the organization default
allowed_modelslist of strings or null
INTELLIGENT only. In the order they were sent.
allowed_providerslist of strings or nullRead-only

INTELLIGENT only. The providers of allowed_models, sorted. Always rebuilt from allowed_models; never stored.

axisenum or null

INTELLIGENT only, else null. What the router optimizes for: COST, PERFORMANCE or CAPABILITY.

Allowed values:
created_atdatetimeRead-only
When the policy was created.
descriptionstring or null
What the policy is for.
idstringRead-only
The policy's id. It stays the same across updates.
is_defaultboolean
Whether this is the organization's default policy.
modelstring or nullRead-only

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.

modified_atdatetimeRead-only
When the policy last changed.
namestring
The policy's name.
priority_orderlist of objects or null
PRIORITY only. Sorted by priority.
slugstring or null

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.

strategyenum

PRIORITY tries priority_order in turn; INTELLIGENT picks among allowed_models per request, optimizing for axis.

Allowed values:
claude_only_for_harnessesbooleanOptionalDefaults to false
Whether this policy's requests from Claude Code, Claude Desktop and the Claude Agent SDK use only Claude models.
complexity_classifier_idstring or nullOptionalformat: "uuid"

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.

cost_speed_presetenumOptionalDefaults to SAVE_COST

INTELLIGENT only. How the router trades cost for speed: SAVE_COST, BALANCED or PREFER_SPEED.

Allowed values:
vendor_priorityobject or nullOptional
The policy's vendor tiers, which replace the organization's for its requests. null when the policy has none.

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
502
Bad Gateway Error
503
Service Unavailable Error