Create authorization code | OpenRouter

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

AuthorizationBearer

API key as bearer token in Authorization header

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

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 = {
12	"Authorization": "Bearer <token>",
13	"Content-Type": "application/json"
14	}
15
16	response = requests.post(url, json=payload, headers=headers)
17
18	print(response.json())