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. Supports https URLs and localhost/127.0.0.1 URLs on any port for local CLI tools.

code_challengestringOptional

PKCE code challenge for enhanced security

code_challenge_methodenumOptional

The method used to generate the code challenge

Allowed values:

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.

limitdoubleOptional

Credit limit for the API key to be created

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

400

Bad Request Error

401

Unauthorized Error

409

Conflict Error

500

Internal Server Error

$	curl -X POST https://openrouter.ai/api/v1/auth/keys/code \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"callback_url": "https://myapp.com/auth/callback",
>	"code_challenge": "E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM",
>	"code_challenge_method": "S256",
>	"limit": 100
>	}'