Start OAuth authentication

Start OAuth authentication flow. Redirects to the OAuth provider’s authorization page.

GET /auth/{provider}/{action}

Start OAuth authentication

cURL

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

400

{
  "code": "<string>",
  "message": "<string>",
  "action": {
    "label": "<string>",
    "url": "<string>"
  },
  "description": "<string>",
  "details": [
    {
      "render": "<string>",
      "title": "<string>",
      "items": [
        "<string>"
      ],
      "object": {}
    }
  ],
  "isInternal": true,
  "metadata": {},
  "requestId": "<string>"
}

Path Parameters

provider · enum<string> · required

Identity provider. saml starts enterprise SAML SSO and requires slug.

Available options: github, google, gitlab, microsoft, saml

action · enum<string> · required

Action to perform

Available options: signup, login, connect-identity

Query Parameters

slug · string | null

Organization SSO slug (required when provider is saml)

invitationToken · string | null

Invitation token from an organization invite link, used to accept the invitation after authentication

plan · string | null

Pricing plan for sign up

ref · string | null

Referral source

next · string | null

URL to redirect to after completion

Response

302

HTTP 302 Found redirect response.