Verify an OAuth session (Google sign-in)
Validates the session obtained via an OAuth provider (currently Google) and runs the exact same checks as password sign-in before granting access:
- The account role must match the requested role (default
organization). - For organization logins, the account must be an active member of an active organization.
- If the account has MFA (TOTP) enrolled, the response returns
MFA_REQUIREDand the client must complete the standard TOTP challenge flow before using the session.
If any check fails, the session is revoked server-side (tokens are invalidated) and a 403 is returned — signing in with Google never bypasses organization membership checks.
Flow: the browser completes the Google OAuth redirect against the platform’s auth service, then posts the
resulting accessToken + refreshToken here. On success the response mirrors
POST /v1/auth/signin, including organization details and team role.
Body
Access token returned by the OAuth sign-in redirect (e.g. Google)
"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
Refresh token from the same OAuth session
"v1.MRjMN..."
The role to verify the session against. Defaults to "organization" (dashboard login).
user, organization "organization"
Related topics
Sign in with GoogleSign in with email and passwordSign up a new userRefresh session tokenUnlink Google account from user