---
title: "Start GitHub OAuth flow"
method: GET
path: "/api/v1/github/connect"
tags: ["github"]
---

# Start GitHub OAuth flow

`GET /api/v1/github/connect`

Initiates the GitHub App installation flow.

## Query parameters

- `return_to` string, nullable — Frontend path to redirect to after OAuth success (e.g., '/' or '/settings/github')

## Response `200`

Successful Response

- ConnectResponse — Response for starting OAuth flow.
  - `authorization_url` string, required
  - `state` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `409` — Conflict
- `422` — Validation Error
- `503` — Service Unavailable

## Changes

- **2026-01-29** `5f4f08ff6556` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/kater-ai/apis/kater-api/changes/api/v1/github/connect/get.md)

---

[API](https://skmtc.dev/kater-ai/apis/kater-api.md) · [All operations](https://skmtc.dev/kater-ai/apis/kater-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kater-ai/kater-api/revisions/d2a2a2d0775e/schema)