Initiate OAuth flow (PKCE)

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

For mobile/desktop 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}

Initiate OAuth flow (PKCE)

cURL

curl --request GET \
  --url https://api.example.com/api/auth/oauth/{provider}

200

{
  "authUrl": "<string>"
}

Path Parameters

provider · enum<string> · required

Available options: google, github, discord, linkedin, facebook, instagram, tiktok, apple, x, spotify, microsoft

Query Parameters

redirect_uri · string<uri> · required

URL to redirect after authentication (receives insforge_code parameter)

code_challenge · string

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

Response

200

application/json

OAuth authorization URL

authUrl · string<uri>

URL to redirect user for OAuth provider login