Management APIRouting policies

Get a routing policy

Authenticates with a management key (manage_routing scope) or any active gateway API key of the organization.

Authentication

AuthorizationBearer

A management key (prefixed mgmt_), created in the dashboard under Settings, API keys, Management keys. Distinct from a regular gateway API key, and never used to call models.

Path parameters

policy_idstringRequiredformat: "uuid"

Response

The policy.
idstringOptionalformat: "uuid"
namestringOptional
descriptionstringOptional
slugstring or nullOptional

The policy’s model alias (bare name), e.g. “fast-experiment”. Null only when no alias could be minted, such as an organization at its alias cap.

modelstring or nullOptional

The ready-to-send model string for this policy, e.g. “@alias/fast-experiment”. Send it as the model in any Gateway request to route with this policy.

strategyenumOptional
allowed_providerslist of stringsOptional
allowed_modelslist of stringsOptional
priority_orderlist of objectsOptional
axisenumOptional

Optimization axis the router optimizes for (INTELLIGENT only, else null); one of COST, PERFORMANCE, CAPABILITY.

created_atdatetimeOptional
modified_atdatetimeOptional

Errors

404
Not Found Error