auth
workos

Build the WorkOS authorization URL and redirect.

  • org_slug — when present, the start endpoint looks up the Organization's WorkOS organization id and routes through the tenant SSO connection, ignoring provider. When absent, routes through one of WorkOS's built-in social providers.
  • provider — one of _SOCIAL_PROVIDERS. Defaults to Google so links minted before this parameter existed keep working.
  • frontend_origin — explicit browser origin. Required for browser logins and must match ALLOWED_FRONTEND_ORIGINS. Used to pick the callback host for dashboard-vs-cloud logins.
  • next — post-login redirect target on the frontend. Validated to root-relative paths only.
  • callback_port — when present, the success path will redirect to http://localhost:<port>/callback instead of setting a browser cookie. Used by qli login and the Electron app.
get/api/auth/workos/start

Request

  • Base URL
    https://api.quadrillion.io (the document declares no server; this is the origin it was published from)
  • URL
    https://api.quadrillion.io/api/auth/workos/start
  • Auth
    none declared

Query parameters

org_slugstring nullable
providerstring
frontend_originstring nullable
nextstring nullable
callback_portinteger nullable
login_hintstring nullable
legalstring nullable
oauth_statestring nullable

Response

Successful Response

unknown required

Changes

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the new optional query request parameter legal

    • info

      added the new optional query request parameter oauth_state