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	curl -X POST https://openrouter.ai/api/v1/auth/keys/code \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"callback_url": "https://myapp.com/auth/callback",
6	"code_challenge": "E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM",
7	"code_challenge_method": "S256",
8	"limit": 100
9	}'