List Routing Strategies

GET

https://api-gateway.merge.dev/routing/strategies

GET

/routing/strategies

$ curl https://api-gateway.merge.dev/routing/strategies

200Retrieved

1 {
2   "object": "list",
3   "data": [
4     {
5       "id": "single",
6       "name": "SINGLE",
7       "is_intelligent": false,
8       "description": "Always use the first configured provider"
9     },
10     {
11       "id": "fallback",
12       "name": "FALLBACK",
13       "is_intelligent": false,
14       "description": "Try providers in priority order until one succeeds"
15     },
16     {
17       "id": "cost_optimized",
18       "name": "COST_OPTIMIZED",
19       "is_intelligent": true,
20       "description": "ML-based routing: route 70%+ of requests to cheaper models",
21       "ml_routing": {
22         "score_exponent": 2,
23         "behavior": "Compresses upper score range (more traffic to cheap models)"
24       }
25     },
26     {
27       "id": "balanced",
28       "name": "BALANCED",
29       "is_intelligent": true,
30       "description": "ML-based routing: balance cost and quality 50/50",
31       "ml_routing": {
32         "score_exponent": 1,
33         "behavior": "Linear score mapping (even distribution)"
34       }
35     }
36   ]
37 }

List all available routing strategies with descriptions.

List Routing Strategies

List Routing Strategies

Response

Response

1	{
2	"object": "list",
3	"data": [
4	{
5	"id": "single",
6	"name": "SINGLE",
7	"is_intelligent": false,
8	"description": "Always use the first configured provider"
9	},
10	{
11	"id": "fallback",
12	"name": "FALLBACK",
13	"is_intelligent": false,
14	"description": "Try providers in priority order until one succeeds"
15	},
16	{
17	"id": "cost_optimized",
18	"name": "COST_OPTIMIZED",
19	"is_intelligent": true,
20	"description": "ML-based routing: route 70%+ of requests to cheaper models",
21	"ml_routing": {
22	"score_exponent": 2,
23	"behavior": "Compresses upper score range (more traffic to cheap models)"
24	}
25	},
26	{
27	"id": "balanced",
28	"name": "BALANCED",
29	"is_intelligent": true,
30	"description": "ML-based routing: balance cost and quality 50/50",
31	"ml_routing": {
32	"score_exponent": 1,
33	"behavior": "Linear score mapping (even distribution)"
34	}
35	}
36	]
37	}