Model Routes

Get a model route

Returns a specific model route

get/v1/projects/{project_id}/model-routes/{route_id}

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/model-routes/{route_id}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Path parameters

route_idstring required
Example:route_V1StGXR8Z5jdHi6B

Model route ID

Response

Model route details

idstring
project_idstring
namestring
retry_onstring[]
failure_thresholdinteger
cooldown_secondsinteger
created_atstring date-time
updated_atstring date-time

Example response

{
  "id": "route_V1StGXR8Z5jdHi6B",
  "name": "primary-with-fallback",
  "targets": [
    {
      "ai_provider_id": "aip_V1StGXR8Z5jdHi6B",
      "model": "gpt-4o-mini",
      "timeout_seconds": 30,
      "max_retries": 1
    }
  ],
  "failure_threshold": 3,
  "cooldown_seconds": 60
}

Changes