Update API key | OpenRouter

Updates an existing API key. Requires a Provisioning API key.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

hashstringRequired

Request

This endpoint expects an object.

namestringOptional

New display name for the key

disabledbooleanOptional

Whether the key should be disabled

limitdouble or nullOptional

New credit limit for the key

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 credit limit

Response

Updated API key

dataobject

1	import requests
2
3	url = "https://openrouter.ai/api/v1/keys/hash"
4
5	payload = {}
6	headers = {
7	"Authorization": "Bearer <token>",
8	"Content-Type": "application/json"
9	}
10
11	response = requests.patch(url, json=payload, headers=headers)
12
13	print(response.json())

1	{
2	"data": {
3	"name": "string",
4	"label": "string",
5	"limit": 1.1,
6	"limit_remaining": 1.1,
7	"limit_reset": "daily",
8	"include_byok_in_limit": true,
9	"usage": 1.1,
10	"usage_daily": 1.1,
11	"usage_weekly": 1.1,
12	"usage_monthly": 1.1,
13	"byok_usage": 1.1,
14	"byok_usage_daily": 1.1,
15	"byok_usage_weekly": 1.1,
16	"byok_usage_monthly": 1.1,
17	"disabled": true,
18	"created_at": "string",
19	"updated_at": "string",
20	"hash": "string"
21	}
22	}