Block

Block Key

post

Block an Virtual key from making any requests.

Parameters:

• key: str - The key to block. Can be either the unhashed key (sk-...) or the hashed key value

Example:

curl --location 'http://0.0.0.0:4000/key/block'     --header 'Authorization: Bearer sk-1234'     --header 'Content-Type: application/json'     --data '{
    "key": "sk-Fn8Ej39NxjAXrvpUGKghGw"
}'

Note: This is an admin-only endpoint. Only proxy admins can block keys.

Authorizations

APIKeyHeader

Header parameters

litellm-changed-byany ofOptional

The litellm-changed-by header enables tracking of actions performed by authorized users on behalf of other users, providing an audit trail for accountability

stringOptional

or

nullOptional

Body

keystringRequired

Responses

Responseany of

or

nullOptional

post

HTTPcURLJavaScriptPython

POST /key/block HTTP/1.1
Host: 
Ocp-Apim-Subscription-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "key": "text"
}

{
  "token": "text",
  "key_name": "text",
  "key_alias": "text",
  "spend": 1,
  "max_budget": 1,
  "expires": "text",
  "models": [],
  "aliases": {},
  "config": {},
  "user_id": "text",
  "team_id": "text",
  "max_parallel_requests": 1,
  "metadata": {},
  "tpm_limit": 1,
  "rpm_limit": 1,
  "budget_duration": "text",
  "budget_reset_at": "2025-04-26T03:57:46.050Z",
  "allowed_cache_controls": [],
  "allowed_routes": [],
  "permissions": {},
  "model_spend": {},
  "model_max_budget": {},
  "soft_budget_cooldown": true,
  "blocked": true,
  "litellm_budget_table": {},
  "org_id": "text",
  "created_at": "2025-04-26T03:57:46.050Z",
  "created_by": "text",
  "updated_at": "2025-04-26T03:57:46.050Z",
  "updated_by": "text"
}