Skip to main content
POST
Issue / refresh token

Headers

Authorization
string

Basic base64(client_id:client_secret) - optional when using client_id/client_secret in the form body

Accept-Language
string

Supported response locales: ko, en, ja, zh-CN, zh-TW, es, fr, de, pt, th, vi. Default is ko.

Example:

"ko"

Body

application/x-www-form-urlencoded

Token exchange request with grant_type=authorization_code

grant_type
enum<string>
required
Available options:
authorization_code
Example:

"authorization_code"

code
string
required

One-time code received from GET /oauth/authorize

redirect_uri
string
required

Must exactly match the authorize step

Example:

"https://builder.example.com/callback"

code_verifier
string
required

PKCE verifier (43-128 characters, [A-Za-z0-9._~-])

Required string length: 43 - 128
client_id
string

Optional when using Basic Auth

client_secret
string

Optional when using Basic Auth

Response

Token issued successfully

RFC 6749 Section 5.1 token response

access_token
string
required

Bearer access token (JWT)

Example:

"eyJhbGciOiJSUzI1NiJ9..."

token_type
string
required

Token type - always Bearer

Example:

"Bearer"

expires_in
integer<int64>
required

Access token lifetime in seconds

Example:

3600

refresh_token
string
required

Plain refresh token (one-time use)

Example:

"rt_a1b2c3d4..."

scope
string
required

Issued scopes (space-separated)

Example:

"profile:read"