This version of GitHub Enterprise was discontinued on 2020-11-12. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Editing a GitHub App's permissions

After registering a GitHub App, you can modify your app's permissions.

Note: Updated permissions won't take effect on an installation until the owner of the account or organization approves the changes. You can use the InstallationEvent webhook to find out when people accept new permissions for your app. One exception is user-level permissions, which don't require the account owner to approve permission changes.

  1. In the upper-right corner of any page, click your profile photo, then click Settings.
    Settings icon in the user bar
  2. In the left sidebar, click Developer settings.
    Developer settings section
  3. In the left sidebar, click GitHub Apps.
    GitHub Apps section
  4. Select the GitHub App whose permissions you want to change.
    App selection
  5. In the left sidebar, click Permissions & webhooks.
    Permissions and webhooks
  6. Modify the permissions you'd like to change. For each type of permission, select either "Read-only", "Read & write", or "No access" from the dropdown.
    Permissions selections for your GitHub App
  7. In "Subscribe to events", select any events to which you'd like to subscribe your app.
    Permissions selections for subscribing your GitHub App to events
  8. Optionally, in "Add a note to users", add a note telling your users why you are changing the permissions that your GitHub App requests.
    Input box to add a note to users explaining why your GitHub App permissions have changed
  9. Click Save changes.
    Button to save permissions changes