Skip to main content
POST
Error

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