OAuth Authentication

OAuth callback handler

Changed on Sep 19, 2026

Handles OAuth provider callback with authorization code. Exchanges code for tokens and creates/signs in user.

get/auth/oauth/{provider}/callback

Request

Base URL: https://api.volcano.dev
URL: https://api.volcano.dev/auth/oauth/{provider}/callback
Auth: none declared

Path parameters

provider'google' | 'github' | 'microsoft' | 'apple' required

Query parameters

codestring required

statestring required

errorstring

Response

Existing user signed in (when redirect_url was omitted)

access_tokenstring required

JWT access token (expires after configured lifetime)

token_typestring required

expires_ininteger required

Access token lifetime in seconds

refresh_tokenstring

Long-lived token for getting new access tokens. Omitted when the request uses eligible HttpOnly cookie session storage.

Example response

{
  "token_type": "bearer"
}

Changes

Sep 19, 20263a6f365f3f35 Revision changes
- ▲
  the response's body type changed from no type to object for status
- ▲
  the response's body type changed from no type to object for status
- ○
  added the optional property to the response with the status
- ○
  added the optional property to the response with the status
- ○
  added the required property to the response with the status
- ○
  added the required property to the response with the status
- ○
  added the required property to the response with the status
- ○
  added the required property to the response with the status
- ○
  added the required property to the response with the status
- ○
  added the required property to the response with the status
- ○
  added the required property to the response with the status
- ○
  added the required property to the response with the status
Aug 27, 2026bb44e98aba2e Revision changes
- ▲
  the response's body type changed from object to no type for status
- ▲
  the response's body type changed from object to no type for status
- ▲
  removed the required property from the response with the status
- ▲
  removed the required property from the response with the status
- ▲
  removed the required property from the response with the status
- ▲
  removed the required property from the response with the status
- ▲
  removed the required property from the response with the status
- ▲
  removed the required property from the response with the status
- ▲
  removed the required property from the response with the status
- ▲
  removed the required property from the response with the status
- ▲
  removed the required property from the response with the status
- ▲
  removed the required property from the response with the status
- ○
  added the non-success response with the status
- ○
  added the non-success response with the status
- ○
  added the non-success response with the status

Operation history