Adding permissions to your GitHub app involves navigating to its settings and modifying the designated sections.
Modifying GitHub App Permissions
To add or change permissions for your GitHub App, follow these steps:
- Navigate to the settings page for the app you'd like to modify. You can typically find your installed GitHub Apps under your account or organization settings.
- In the GitHub Apps settings sidebar, click Permissions & events. This section is where you manage what your app can access and what events it can receive webhooks for.
- Under the sections Repository permissions, Organization permissions, and Account permissions, modify the permissions you'd like to change. Here you can specify the level of access your app needs for different types of resources.
By adjusting the settings in the Permissions & events section, you control what data and actions your GitHub App has access to across repositories, organizations, and user accounts.
Types of Permissions
GitHub App permissions are categorized to help you define granular access. The reference mentions modifying permissions under these key sections:
| Permission Category | Applies To |
|---|---|
| Repository permissions | Actions within repositories |
| Organization permissions | Actions within an organization |
| Account permissions | Actions related to user accounts |
Modifying these permissions ensures your app only has the access necessary to perform its intended functions, adhering to the principle of least privilege.
