Create a routing policy

Create an org routing policy. The first policy becomes the org default automatically. Requires the manage_routing scope.

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.

Request

This endpoint expects an object.

namestringRequired<=255 characters

strategyenumRequired

descriptionstringOptional

is_defaultbooleanOptional

Make this the org default (unsets the previous default).

allowed_providerslist of stringsOptional

INTELLIGENT only, optional. If provided, must match the providers of allowed_models (it does not filter independently); returned derived from allowed_models on reads.

allowed_modelslist of stringsOptional

INTELLIGENT only.

priority_orderlist of objectsOptional

PRIORITY only.

Response

The created policy.

idstringformat: "uuid"

namestring

descriptionstring

strategyenum

allowed_providerslist of strings

allowed_modelslist of strings

priority_orderlist of objects

created_atdatetime

modified_atdatetime

Errors

422

Unprocessable Entity Error

$	curl -X POST https://api-gateway.merge.dev/v1/routing-policies \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "string",
>	"strategy": "PRIORITY"
>	}'

1	{
2	"id": "string",
3	"name": "string",
4	"description": "string",
5	"strategy": "PRIORITY",
6	"allowed_providers": [
7	"string"
8	],
9	"allowed_models": [
10	"string"
11	],
12	"priority_order": [
13	{
14	"model": "openai/gpt-5.5",
15	"priority": 1
16	}
17	],
18	"created_at": "2024-01-15T09:30:00Z",
19	"modified_at": "2024-01-15T09:30:00Z"
20	}