List model limits

Returns a paginated list of model limits with their budget and rate limit settings.

GET /api/governance/model-configs

Error

A valid request URL is required to generate request examples

200

{
  "model_configs": [
    {
      "id": "<string>",
      "model_name": "<string>",
      "provider": "<string>",
      "scope": "global",
      "scope_id": "<string>",
      "scope_name": "<string>",
      "source_type": "<string>",
      "source_id": "<string>",
      "source_name": "<string>",
      "calendar_aligned": false,
      "budgets": [
        {
          "id": "<string>",
          "max_limit": 123,
          "reset_duration": "<string>",
          "last_reset": "2023-11-07T05:31:56Z",
          "current_usage": 123,
          "config_hash": "<string>",
          "created_at": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z",
          "reset_config": {
            "quarter_start_month": 6
          },
          "override_amount": 123,
          "override_mode": "cycles",
          "override_cycles_remaining": 123,
          "override_cycles_total": 123,
          "override_anchor_reset": "2023-11-07T05:31:56Z",
          "team_id": "<string>",
          "virtual_key_id": "<string>",
          "provider_config_id": 123
        }
      ],
      "budget": {
        "id": "<string>",
        "max_limit": 123,
        "reset_duration": "<string>",
        "last_reset": "2023-11-07T05:31:56Z",
        "current_usage": 123,
        "config_hash": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "reset_config": {
          "quarter_start_month": 6
        },
        "override_amount": 123,
        "override_mode": "cycles",
        "override_cycles_remaining": 123,
        "override_cycles_total": 123,
        "override_anchor_reset": "2023-11-07T05:31:56Z",
        "team_id": "<string>",
        "virtual_key_id": "<string>",
        "provider_config_id": 123
      },
      "rate_limit": {
        "id": "<string>",
        "token_current_usage": 123,
        "token_last_reset": "2023-11-07T05:31:56Z",
        "request_current_usage": 123,
        "request_last_reset": "2023-11-07T05:31:56Z",
        "config_hash": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "token_max_limit": 123,
        "token_reset_duration": "<string>",
        "request_max_limit": 123,
        "request_reset_duration": "<string>"
      },
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "total_count": 123
}

Authorizations

ManagementBearerAuthBasicAuth

Authorization · string · header · required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <token>, where <token> is one of:

• a Bifrost management API key,
• a dashboard session token issued by POST /api/session/login,
• base64 of <admin-username>:<admin-password> (legacy equivalent of BasicAuth).

Virtual keys (sk-bf-*) and the x-api-key header are not accepted on management APIs - the sole exception is GET /api/governance/virtual-keys/quota, which is virtual-key-only.

Query Parameters

limit · integer

Maximum number of results to return

Required range: x >= 1

offset · integer

Number of results to skip (for pagination)

Required range: x >= 0

search · string

Case-insensitive filter by model name

scope · string

Comma-separated scopes to filter by. project, access_profile and the legacy user are Enterprise only.

scope_id · string

Filter to one scope target, for example a project id. Pair it with scope.

provider · string

Filter by provider name

from_memory · boolean · default: false

If true, returns data from in-memory cache (faster, may lag DB by one poll cycle)

Response

200

application/json

Successful response

Response containing list of model configs

model_configs · object[]

Show child attributes

total_count · integer

Total number of model configs matching the filter (used for pagination)