Skip to main content
GET
/
api
/
v1
/
routing-preferences
List Routing Preferences
curl --request GET \
  --url https://api.example.com/api/v1/routing-preferences
{
  "routing_preferences": [
    {}
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.hitheo.ai/llms.txt

Use this file to discover all available pages before exploring further.

Returns every preference authored by the caller plus every team-scoped preference in the active organization. Each preference bundles a set of keyword rules, few-shot examples, and per-mode confidence-floor overrides that bias Theo’s routing engine for the caller’s domain. Hidden per-key preferences (the rows backing the per-key routing-rules surface) are excluded from this listing — manage those via /api/v1/keys/{id}/routing-rules instead.

​
Authentication

Requires a Bearer token with the billing API key scope. See Authentication.

​
Request Examples

curl https://www.hitheo.ai/api/v1/routing-preferences \
  -H "Authorization: Bearer $THEO_API_KEY"

​
Response

​
routing_preferences
object[]
Array of preference objects. Each preference includes id, name, description, user_id, org_id, enabled, is_default, rules, examples, and confidence_floor_overrides.

​
Example Response

{
  "routing_preferences": [
    {
      "id": "1f4f2c1a-22ce-4b07-9c0b-9c4f4b9b1d2e",
      "name": "ContractIQ Legal",
      "description": "Contract terms get the analytical engine.",
      "user_id": "user_abc",
      "org_id": null,
      "enabled": true,
      "is_default": false,
      "rules": [
        {
          "id": "r_a4b8c01x9y",
          "pattern": "\\b(clause|provision|indemnity|warranty)\\b",
          "target_mode": "think",
          "confidence": 0.92,
          "description": "Contract terms get the analytical engine."
        }
      ],
      "examples": [
        { "prompt": "Look at this clause", "expected_mode": "think" }
      ],
      "confidence_floor_overrides": {
        "think": 0.65
      }
    }
  ]
}