---
title: "Initiate Oauth"
method: GET
path: "/v1/oauth/initiate"
tags: ["OAuth"]
---

# Initiate Oauth

`GET /v1/oauth/initiate`

Generate authorization URL for OAuth authentication.

## Query parameters

- `redirect_uri` string, required — URI to redirect after authentication
- `code_challenge` string, nullable — PKCE code challenge (S256)
- `connection_id` string, nullable — Optional WorkOS connection ID for SSO
- `organization_id` string, nullable — Organization ID to scope the authentication to

## Response `200`

Successful Response

- OAuthInitiateResponse — Response for OAuth initiation.
  - `authorization_url` string, required — URL to redirect user for authentication
  - `state` string, required — State parameter for CSRF protection

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/terminaluse/apis/sb0-api.md) · [All operations](https://skmtc.net/terminaluse/apis/sb0-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/terminaluse/sb0-api/revisions/f24a474dc415/schema)