Remove virtual key budget override

Removes any active override from the budget, so it is enforced against its base max_limit again. The budget’s current usage and reset schedule are unchanged, and the removal is permanent — a cleared grant cannot be re-derived. Safe to call on a budget that has no override.

DELETE /api/governance/virtual-keys/{vk_id}/budgets/{budget_id}/override

Error

A valid request URL is required to generate request examples

200

{
  "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
    },
    "calendar_aligned": false,
    "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
  },
  "effective_max_limit": 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.

Path Parameters

vk_id · string · required

Virtual key ID

budget_id · string · required

ID of a budget owned by the virtual key

Response

200

application/json

Budget override removed successfully

The persisted budget and the additive limit now in force.

budget · object · required

Budget configuration

Show child attributes

effective_max_limit · number · required

max_limit plus override_amount while an override is active; equal to max_limit otherwise.