Create authorization code | OpenRouter

Create an authorization code for the PKCE flow to generate a user-controlled API key

This endpoint expects an object.

callback_urlstringRequiredformat: "uri"

The callback URL to redirect to after authorization. Note, only https URLs on ports 443 and 3000 are allowed.

code_challengestringOptional

PKCE code challenge for enhanced security

code_challenge_methodenumOptional

The method used to generate the code challenge

Allowed values:

limitdoubleOptional

Credit limit for the API key to be created

expires_atdatetime or nullOptional

Optional expiration time for the API key to be created

key_labelstringOptional<=100 characters

Optional custom label for the API key. Defaults to the app name if not provided.

usage_limit_typeenumOptional

Optional credit limit reset interval. When set, the credit limit resets on this interval.

Allowed values:

Successfully created authorization code

dataobject

Auth code data

1	import requests
2
3	url = "https://openrouter.ai/api/v1/auth/keys/code"
4
5	payload = {
6	"callback_url": "https://myapp.com/auth/callback",
7	"code_challenge": "E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM",
8	"code_challenge_method": "S256",
9	"limit": 100
10	}
11	headers = {"Content-Type": "application/json"}
12
13	response = requests.post(url, json=payload, headers=headers)
14
15	print(response.json())