---
title: "Bot Overview"
method: GET
path: "/github-app/bot-overview"
tags: ["github-app"]
---

# Bot Overview

`GET /github-app/bot-overview`

Aggregated payload for the /settings?tab=bot management page.

Returns the user's claimed bot installs (with covered repos and
latest-snapshot metadata), unclaimed bot installs they could claim
(username match OR an org they belong to, when ``X-GitHub-Token`` is
supplied), and ``github_username`` itself so the frontend doesn't
need a separate /auth/me round-trip.

Passing ``X-GitHub-Token`` (the Supabase session's provider_token)
enables org-install discovery. The backend cross-checks the token's
GitHub identity against the user's ``github_username`` before
enumerating orgs — submitting someone else's token is a no-op.

## Headers

- `x-github-token` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

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