---
title: "Start a Google or GitHub sign-in"
method: GET
path: "/v1/auth/oauth/{provider}/start"
tags: ["Auth"]
---

# Start a Google or GitHub sign-in

`GET /v1/auth/oauth/{provider}/start`

## Request

- Base URL: `https://www.chatrail.dev`
- URL: `https://www.chatrail.dev/v1/auth/oauth/{provider}/start`
- Auth: none required

A browser navigation, not an API call: redirects to the provider with a state value and a PKCE challenge held in a short-lived HttpOnly cookie. An optional same-origin `next` path is where the person lands afterwards.

## Path parameters

- `provider` string, required

## Other responses

- `302`: Redirect to the provider.
- `404`: That provider is not configured.

---

[API](https://skmtc.dev/chatrail/apis/chatrail-api.md) · [All operations](https://skmtc.dev/chatrail/apis/chatrail-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatrail/apis/chatrail-api/revisions/acc5b88c6f59?raw)
