---
title: "Check GitHub connection status"
method: GET
path: "/github/status"
tags: ["GitHub"]
---

# Check GitHub connection status

`GET /github/status`

## Request

- Base URL: `https://api.apphandoff.com/api`
- URL: `https://api.apphandoff.com/api/github/status`
- Auth: API key in cookie `sb-access-token`

Returns whether the user has a valid GitHub token, repo scope, and app installation.

## Response `200`

GitHub connection status

- object
  - `connected` boolean, required
  - `username` string, nullable
  - `avatarUrl` string, nullable
  - `reason` 'token_invalid' | 'missing_repo_scope' | 'github_unreachable': Reason for disconnection
  - `appInstalled` boolean, required
  - `appInstallConfigured` boolean, required

## Other responses

- `401`: Not authenticated

---

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