v1

latestOpenAPI 3.0.32026-07-26172157253.6 KB
Client

Initiate OAuth flow (PKCE)

Generate OAuth authorization URL for any supported provider using PKCE flow.

For mobile/desktop/server clients using PKCE:

  1. Generate code_verifier (random string, 43-128 chars)
  2. Generate code_challenge = Base64URL(SHA256(code_verifier))
  3. Call this endpoint with code_challenge
  4. After OAuth callback, use /api/auth/oauth/exchange with code_verifier
get/api/auth/oauth/{provider}

Path parameters

provider'google' | 'github' | 'discord' | 'linkedin' | 'facebook' | 'instagram' | 'tiktok' | 'apple' | 'x' | 'spotify' | 'microsoft' required

Query parameters

redirect_uristring uri required

URL to redirect after authentication (receives insforge_code parameter)

code_challengestring

PKCE code challenge for mobile/desktop/server clients. Generate using: Base64URL(SHA256(code_verifier)) Required for secure token exchange in native apps or trusted server-side clients.

Response

OAuth authorization URL

authUrlstring uri

URL to redirect user for OAuth provider login