Create model config

Creates a new model configuration with budget and rate limit settings.

scope: "user" is rejected with 403. It is retired as a creatable scope — per-model budgets for a person are now declared on an access profile and materialize per user as access_profile-scoped limits. Existing user-scoped rows keep working and stay editable through the update endpoint.

POST /api/governance/model-configs

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.

Body

application/json

Request to create a new model config

model_name · string · required

Name of the model (required). Use * to match all models.

provider · string

Provider name (optional - applies to all providers if not specified)

scope · enum<string> · default: global

Scope where this limit applies. Defaults to global. project targets a governance project (Enterprise only). The legacy user scope is refused on create; use an access profile instead.

Available options: global, virtual_key, project

scope_id · string

ID of the scope target, for example a virtual key id or a project id. Required when scope is not global.

budgets · object[]

Budget lines for this limit. Each entry must have a unique reset_duration.

Show child attributes

rate_limit · object

Rate limit configuration

Show child attributes

Response

200

application/json

Model config created successfully

Response containing a created/updated model config

message · string

model_config · object

Model configuration with budget and rate limit settings

Show child attributes