Issue / refresh token
Issues or refreshes a user-context access token. With grant_type=authorization_code, use the code from /oauth/authorize and the PKCE code_verifier; with grant_type=refresh_token, use the refresh_token. Send the returned access_token as Authorization: Bearer <jwt> for user-context /api/v1/** and /oauth/userinfo calls. Client authentication is HTTP Basic or client_id/client_secret in the request body.
Headers
Basic base64(client_id:client_secret) - optional when using client_id/client_secret in the form body
Supported response locales: ko, en, ja, zh-CN, zh-TW, es, fr, de, pt, th, vi. Default is ko.
"ko"
Body
- Option 1
- Option 2
Token exchange request with grant_type=authorization_code
authorization_code "authorization_code"
One-time code received from GET /oauth/authorize
Must exactly match the authorize step
"https://builder.example.com/callback"
PKCE verifier (43-128 characters, [A-Za-z0-9._~-])
43 - 128Optional when using Basic Auth
Optional when using Basic Auth
Response
Token issued successfully
RFC 6749 Section 5.1 token response
Bearer access token (JWT)
"eyJhbGciOiJSUzI1NiJ9..."
Token type - always Bearer
"Bearer"
Access token lifetime in seconds
3600
Plain refresh token (one-time use)
"rt_a1b2c3d4..."
Issued scopes (space-separated)
"profile:read"