Update model config

Updates an existing model configuration’s budget and rate limit settings.

PUT /api/governance/model-configs/{mc_id}

Error

A valid request URL is required to generate request examples

200

{
  "message": "<string>",
  "model_config": {
    "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"
  }
}

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.

Path Parameters

mc_id · string · required

Model config ID

Body

application/json

Request to update an existing model config. Scope and scope_id are identity fields and cannot be changed.

model_name · string

Name of the model

provider · string

Provider name

budgets · object[]

Full desired set of budgets (reconciled server-side). Send an empty array to remove all budgets.

Show child attributes

rate_limit · object

Rate limit configuration

Show child attributes

reset_budget_usage · boolean

When true, zeroes current usage on the budgets reconciled by this update. The reset window is left alone: last_reset only ever advances, and never as a side effect of a configuration write, so the current window keeps its existing start and end.

Response

200

application/json

Model config updated successfully

Response containing a created/updated model config

message · string

model_config · object

Model configuration with budget and rate limit settings

Show child attributes