v1

latestOpenAPI 3.1.02026-07-2617125852.3 KB

OAuth

Initialize google oauth

Creates an OAuth session and returns the Google authorization URL. The user should be redirected to auth_url to complete the OAuth flow. Poll the status endpoint to check for completion.

Special rate limits (stricter than the standard API rate limit) to comply with upstream Google rate limits:

75 requests per minute per workspace
150 requests per minute per IP

If Google's upstream OAuth service is temporarily unavailable, requests may return 503.

post/api/v2/oauth/google/init

Response

Default Response

session_idstring

Session ID for polling status

auth_urlstring

Google authorization URL to redirect user to

expires_atstring date-time

Session expiry time (10 minutes from creation)

Example response

{
  "session_id": "abc123def456",
  "auth_url": "https://accounts.google.com/o/oauth2/auth?...",
  "expires_at": "2026-01-14T12:30:00.000Z"
}