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"