Update an API key | OpenRouter

curl -X PATCH https://openrouter.ai/api/v1/keys/f01d52606dc8f0a8303a7b5cc3fa07109c2e346cec7c0a16b40de462992ce943 \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Updated API Key Name",
  "disabled": false,
  "limit": 75,
  "limit_reset": "daily",
  "include_byok_in_limit": true
}'

{
  "data": {
    "hash": "f01d52606dc8f0a8303a7b5cc3fa07109c2e346cec7c0a16b40de462992ce943",
    "name": "Updated API Key Name",
    "label": "Updated API Key Name",
    "disabled": false,
    "limit": 75,
    "limit_remaining": 49.5,
    "limit_reset": "daily",
    "include_byok_in_limit": true,
    "usage": 25.5,
    "usage_daily": 25.5,
    "usage_weekly": 25.5,
    "usage_monthly": 25.5,
    "byok_usage": 17.38,
    "byok_usage_daily": 17.38,
    "byok_usage_weekly": 17.38,
    "byok_usage_monthly": 17.38,
    "created_at": "2025-08-24T10:30:00Z",
    "updated_at": "2025-08-24T16:00:00Z"
  }
}

Update an existing API key. Management key required.

Authentication

AuthorizationBearer

API key as bearer token in Authorization header

Path parameters

hashstringRequired

The hash identifier of the API key to update

Request

This endpoint expects an object.

namestringOptional

New name for the API key

disabledbooleanOptional

Whether to disable the API key

limitdouble or nullOptional

New spending limit for the API key in USD

limit_resetenum or nullOptional

New limit reset type for the API key (daily, weekly, monthly, or null for no reset). Resets happen automatically at midnight UTC, and weeks are Monday through Sunday.

Allowed values:

include_byok_in_limitbooleanOptional

Whether to include BYOK usage in the limit

Response

API key updated successfully

dataobject

The updated API key information

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error