Preview alias routing

Simulate the routing resolution for this alias as it would happen at request time.

Returns the model that would be selected as primary, the ordered list of fallbacks, and any models currently excluded from routing (e.g. because they are unhealthy).

This is useful for debugging alias configuration and verifying that health checks and priority settings produce the expected routing outcome.

GET /api/v3/aliases/{id}/route

Preview alias routing

cURL

curl --request GET \
  --url https://paradigm.lighton.ai/api/v3/aliases/{id}/route \
  --header 'Authorization: Bearer <token>'

200

{
  "primary": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "technical_name": "<string>"
  },
  "fallbacks": [],
  "excluded": []
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id · string<uuid> · required

Response

200

application/json

primary · object · required

The model that would be selected as primary for inference

Show child attributes

fallbacks · object[]

Ordered fallback models, from highest to lowest priority

Show child attributes

excluded · object[]

Models excluded from routing (e.g. currently unhealthy)

Show child attributes