Exchange authorization code for API key | OpenRouter

Exchange an authorization code from the PKCE flow for a user-controlled API key

AuthorizationBearer

API key as bearer token in Authorization header

This endpoint expects an object.

codestringRequired

The authorization code received from the OAuth redirect

code_verifierstringOptional

The code verifier if code_challenge was used in the authorization request

code_challenge_methodenum or nullOptional

The method used to generate the code challenge

Allowed values:

Successfully exchanged code for an API key

keystring

The API key to use for OpenRouter requests

user_idstring or null

User ID associated with the API key

1	import requests
2
3	url = "https://openrouter.ai/api/v1/auth/keys"
4
5	payload = {
6	"code": "auth_code_abc123def456",
7	"code_verifier": "dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk",
8	"code_challenge_method": "S256"
9	}
10	headers = {
11	"Authorization": "Bearer <token>",
12	"Content-Type": "application/json"
13	}
14
15	response = requests.post(url, json=payload, headers=headers)
16
17	print(response.json())

1	{
2	"key": "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",
3	"user_id": "user_2yOPcMpKoQhcd4bVgSMlELRaIah"
4	}