​

Disconnect a GitHub account

Disconnect a GitHub account when a Qodex project should no longer use that GitHub App install. This removes the project grant and unlinks repos connected through that install. It does not uninstall the GitHub App from GitHub.

​

Prerequisites

• You are an owner or maintainer on the Qodex project.
• You know which install you want to disconnect (the panel lists them by GitHub account login).

​

1. Open Connected accounts

In your project, open Settings > Integrations > GitHub > Connected accounts. Each row is one GitHub install granted to this project, with its account login, install type, repo count, and Disconnect button.

​

2. Click Disconnect

A confirmation modal lists the repos that will be unlinked from this Qodex project.

​

3. Confirm

Qodex revokes this project’s access to the install and unlinks every repo this project pulled through it. The GitHub install itself is preserved. Other Qodex projects that have their own access to the same install keep working.

​

What this does not do

Disconnecting from a Qodex project does not uninstall the App from GitHub. The GitHub App remains installed on the account, and other Qodex projects with their own grant continue to work. To fully uninstall the App from GitHub, go to github.com/settings/installations (or the organization equivalent at github.com/organizations/{org}/settings/installations), find the Qodex install, and click Uninstall. GitHub revokes the access token, and Qodex’s record of the install becomes unusable.

​

Defense in depth

The disconnect is enforced on the server, not only in the UI. Even if a stale picker showed an install the project no longer has access to, any attempt to link a repo through it would be refused before any GitHub call is made. The same GitHub install can be shared by multiple projects, and revoked from some but not others. The picker is a hint; the server is the truth.

​

Try it yourself

​

Next steps