Create authorization code

POST

https://novapai.ai/api/v1/auth/keys/code

POST

/api/v1/auth/keys/code

cURL


$curl -X POST https://novapai.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
>\}'

200 Successful

reference-o-auth-create-auth-keys-code-01.json


{
  "data": {
    "id": "auth_code_xyz789",
    "app_id": 12345,
    "created_at": "2025-08-24T10:30:00Z"
  }
}

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

Authentication

Authorization Bearer

API key as bearer token in Authorization header

Request

This endpoint expects an object.

字段	类型	必填	说明
callback_url	string	是	`format: "uri"` The callback URL to redirect to after authorization. Note, only https URLs on ports 443 and 3000 are allowed.
code_challenge	string	否	PKCE code challenge for enhanced security
code_challenge_method	enum	否	The method used to generate the code challenge Allowed values:S256 plain
limit	double	否	Credit limit for the API key to be created
expires_at	datetime or null	否	Optional expiration time for the API key to be created
key_label	string	否	`<=100 characters` Optional custom label for the API key. Defaults to the app name if not provided.
usage_limit_type	enum	否	Optional credit limit reset interval. When set, the credit limit resets on this interval. Allowed values:daily weekly monthly

Response

Successfully created authorization code

字段	类型	必填	说明
data	object	-	Auth code data

Errors

状态码	说明
400	Bad Request Error
401	Unauthorized Error
409	Conflict Error
500	Internal Server Error