About installed GitHub Apps

GitHub users can install GitHub Apps on their personal account or accounts they own. When you install a GitHub App, you grant the app the organization and repository permissions that it requested. If the app requested repository permissions, you also specify which repositories the GitHub App can access.

You should periodically review the GitHub Apps that you have installed. You can review the permissions that you granted and change the repositories that the GitHub App can access. If you no longer use an app, consider suspending or deleting the GitHub App to block its access to resources owned by the account where it is installed.

In addition to reviewing GitHub Apps that you have installed, you can review GitHub Apps that you have authorized to act on your behalf. For more information, seeReviewing and revoking authorization of GitHub Apps.

Navigating to the GitHub App you want to review or modify

• For a GitHub App installed on an organization:

  1. In the top right corner of GitHub, click your profile picture, then clickYour organizations.
  2. Next to your organization name, clickSettings.
  3. In the side bar, under "Third-party Access," clickGitHub Apps. A list of the GitHub Apps installed on your organization will be displayed.
  4. Next to the GitHub App you want to review or modify, clickConfigure.

• For a GitHub App installed on your personal account:

  1. In the upper-right corner of any page, click your profile picture, then clickSettings.
  2. Under "Integrations," clickApplications.
  3. ClickInstalled GitHub Apps. A list of the GitHub Apps installed on your personal account will be displayed.
  4. Next to the GitHub App you want to review or modify, clickConfigure.

• For a repository where a GitHub App was granted access:

  Note

  In the following steps, you will be taken to the account settings for the organization or personal account where the GitHub App is installed. The settings will affect all repositories where the app is installed under that account, not just the repository where you navigated from.

  1. Navigate to the main page of the organization or repository.

  2. Click Settings.

  3. Under "Integrations," clickGitHub Apps. A list of the GitHub Apps that have been granted access to your repository will be displayed.

  4. Next to the GitHub App you want to review or modify, clickConfigure.

Reviewing permissions

1. Navigate to the GitHub App you want to modify. For more information, seeNavigating to the GitHub App you want to review or modify.
2. Under "Permissions," review the permissions that the GitHub App has. For more information about what different permissions enable a GitHub App to do, seeChoosing permissions for a GitHub App.

Modifying repository access

1. Navigate to the GitHub App you want to modify. For more information, seeNavigating to the GitHub App you want to review or modify.

2. Under "Repository access," selectAll repositories orOnly select repositories.

3. If you selectedOnly select repositories in the previous step, under theSelect repositories dropdown, select the repositories that you want the GitHub App to access.

   If the GitHub App creates any repositories later, the app will automatically be granted access to those repositories as well.

4. ClickSave.

Blocking access

1. Navigate to the GitHub App you want to modify. For more information, seeNavigating to the GitHub App you want to review or modify.

2. To keep the GitHub App installed for future use but temporarily block it from accessing resources owned by your account, clickSuspend.

   When you suspend a GitHub App, your authorization of the app (if the app is installed on your personal account) or the authorization of the app by members of your account (if the app is installed on an organization) will not be affected. For more information, seeAuthorizing GitHub Apps.

   If the GitHub App was previously suspended, you can unsuspend the app by clickingUnsuspend. If the GitHub App was suspended by the GitHub App owner, then you cannot unsuspend the app.

3. To uninstall a GitHub App and block it from accessing resources owned by your account, clickUninstall.

   When you uninstall a GitHub App from an account, the app will lose access to the resources in just that account. The app might still be authorized to access other accounts on your behalf, if it has installations in those accounts.

   If you want to stop an app from acting on your behalf anywhere on GitHub, also de-authorize the app in the "Authorized GitHub Apps" tab of your user account. This will fully deactivate any tokens issued to the app on your behalf. For more information, seeAuthorizing GitHub Apps.

Further reading

• Reviewing and revoking authorization of GitHub Apps
• Privileged GitHub Apps