Skip to main content
POST
/
api
/
governance
/
model-configs
Error
A valid request URL is required to generate request examples
{
  "message": "<string>",
  "model_config": {
    "id": "<string>",
    "model_name": "<string>",
    "provider": "<string>",
    "scope": "global",
    "scope_id": "<string>",
    "scope_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",
        "calendar_aligned": false,
        "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",
      "calendar_aligned": false,
      "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

​
Authorization
string
header
required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <API key>. Virtual keys, dashboard/user/session tokens, and x-api-key headers are not supported on management APIs.

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.

Available options:
global,
virtual_key,
user
​
scope_id
string

ID of the scope target (e.g. virtual key ID or user ID). Required when scope is not global.

​
budgets
object[]

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

​
rate_limit
object

Rate limit configuration

Response

Model config created successfully

Response containing a created/updated model config

​
message
string
​
model_config
object

Model configuration with budget and rate limit settings