Update an API key | OpenRouter

1 import requests 2 3 url = "https://openrouter.ai/api/v1/keys/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" 4 5 payload = { 6 "name": "Updated API Key Name", 7 "disabled": False, 8 "limit": 75, 9 "limit_reset": "daily", 10 "include_byok_in_limit": True 11 } 12 headers = { 13 "Authorization": "Bearer <token>", 14 "Content-Type": "application/json" 15 } 16 17 response = requests.patch(url, json=payload, headers=headers) 18 19 print(response.json())

1 { 2 "data": { 3 "hash": "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", 4 "name": "Updated API Key Name", 5 "label": "Updated API Key Name", 6 "disabled": false, 7 "limit": 75, 8 "limit_remaining": 49.5, 9 "limit_reset": "daily", 10 "include_byok_in_limit": true, 11 "usage": 25.5, 12 "usage_daily": 25.5, 13 "usage_weekly": 25.5, 14 "usage_monthly": 25.5, 15 "byok_usage": 17.38, 16 "byok_usage_daily": 17.38, 17 "byok_usage_weekly": 17.38, 18 "byok_usage_monthly": 17.38, 19 "created_at": "2025-08-24T10:30:00Z", 20 "updated_at": "2025-08-24T16:00:00Z" 21 } 22 }

Authentication

AuthorizationBearer

API key as bearer token in Authorization header

Path parameters

hashstringRequired

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