docs/content/apps/using-github-apps/reviewing-and-modifying-installed-github-apps.md

title, shortTitle, intro, versions, topics

title	shortTitle	intro	versions	topics
Reviewing and modifying installed GitHub Apps	Review installations	You can review the permissions and change the repository access for {% data variables.product.prodname_github_apps %} that you have installed. You can also temporarily or permanently prevent a {% data variables.product.prodname_github_app %} from accessing resources owned by your account or organization.	fpt ghes ghec * * *	GitHub Apps

About installed {% data variables.product.prodname_github_apps %}

{% data variables.product.company_short %} users can install {% data variables.product.prodname_github_apps %} on their personal account or accounts they own. When you install a {% data variables.product.prodname_github_app %}, you grant the app the {% ifversion enterprise-installed-apps %}enterprise or {% endif %}organization and repository permissions that it requested. If the app requested repository permissions, you also specify which repositories the {% data variables.product.prodname_github_app %} can access.{% ifversion enterprise-installed-apps %} Installing an app on an enterprise only grants enterprise permissions. To grant organization and repository permissions, install the app on an organization.{% endif %}

You should periodically review the {% data variables.product.prodname_github_apps %} that you have installed. You can review the permissions that you granted and change the repositories that the {% data variables.product.prodname_github_app %} can access. If you no longer use an app, consider suspending or deleting the {% data variables.product.prodname_github_app %} to block its access to resources owned by the account where it is installed.

In addition to reviewing {% data variables.product.prodname_github_apps %} that you have installed, you can review {% data variables.product.prodname_github_apps %} that you have authorized to act on your behalf. For more information, see AUTOTITLE.

Navigating to the {% data variables.product.prodname_github_app %} you want to review or modify

{% ifversion enterprise-installed-apps %}* For a {% data variables.product.prodname_github_app %} installed on an enterprise:

1. In the top right corner of {% data variables.product.prodname_dotcom %}, click your profile picture, then click Your enterprises.
2. Next to your enterprise name, click Settings.
3. In the top navigation bar, click Settings.
4. In the side bar, click GitHub Apps. A list of the {% data variables.product.prodname_github_apps %} owned by your enterprise will be displayed.
5. Switch to the Installed Apps tab to see a list of the apps installed on your enterprise.
6. Next to the {% data variables.product.prodname_github_app %} you want to review or modify, click Configure.{% endif %}

• For a {% data variables.product.prodname_github_app %} installed on an organization:

  1. In the top right corner of {% data variables.product.prodname_dotcom %}, click your profile picture, then click Your organizations.
  2. Next to your organization name, click Settings.
  3. In the side bar, under "Third-party Access," click GitHub Apps. A list of the {% data variables.product.prodname_github_apps %} installed on your organization will be displayed.
  4. Next to the {% data variables.product.prodname_github_app %} you want to review or modify, click Configure.

• For a {% data variables.product.prodname_github_app %} installed on your personal account:

  1. In the upper-right corner of any page, click your profile picture, then click Settings.
  2. Under "Integrations," click Applications.
  3. Click Installed GitHub Apps. A list of the {% data variables.product.prodname_github_apps %} installed on your personal account will be displayed.
  4. Next to the {% data variables.product.prodname_github_app %} you want to review or modify, click Configure.

• For a repository where a {% data variables.product.prodname_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 {% data variables.product.prodname_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 {% octicon "gear" aria-hidden="true" aria-label="gear" %} Settings.

  3. Under "Integrations," click GitHub Apps. A list of the {% data variables.product.prodname_github_apps %} that have been granted access to your repository will be displayed.

  4. Next to the {% data variables.product.prodname_github_app %} you want to review or modify, click Configure.

Reviewing permissions

1. Navigate to the {% data variables.product.prodname_github_app %} you want to modify. For more information, see Navigating to the GitHub App you want to review or modify.
2. Under "Permissions," review the permissions that the {% data variables.product.prodname_github_app %} has. For more information about what different permissions enable a {% data variables.product.prodname_github_app %} to do, see AUTOTITLE.

Modifying repository access

1. Navigate to the {% data variables.product.prodname_github_app %} you want to modify. For more information, see Navigating to the GitHub App you want to review or modify.

2. Under "Repository access," select All repositories or Only select repositories.

3. If you selected Only select repositories in the previous step, under the Select repositories dropdown, select the repositories that you want the {% data variables.product.prodname_github_app %} to access.

   If the {% data variables.product.prodname_github_app %} creates any repositories later, the app will automatically be granted access to those repositories as well.

4. Click Save.

Blocking access

1. Navigate to the {% data variables.product.prodname_github_app %} you want to modify. For more information, see Navigating to the GitHub App you want to review or modify.

2. To keep the {% data variables.product.prodname_github_app %} installed for future use but temporarily block it from accessing resources owned by your account, click Suspend.

   When you suspend a {% data variables.product.prodname_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{% ifversion enterprise-installed-apps %} or enterprise{% endif %}) will not be affected. For more information, see AUTOTITLE.

   If the {% data variables.product.prodname_github_app %} was previously suspended, you can unsuspend the app by clicking Unsuspend. If the {% data variables.product.prodname_github_app %} was suspended by the {% data variables.product.prodname_github_app %} owner, then you cannot unsuspend the app.

3. To uninstall a {% data variables.product.prodname_github_app %} and block it from accessing resources owned by your account, click Uninstall.

   When you uninstall a {% data variables.product.prodname_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 {% data variables.product.github %}, also de-authorize the app in the "Authorized {% data variables.product.prodname_github_apps %}" tab of your user account. This will fully deactivate any tokens issued to the app on your behalf. For more information, see AUTOTITLE.

Further reading

• AUTOTITLE
• AUTOTITLE