GitHub App Permissions

Note: To access the API with your integration, you must provide a custom media type in the Accept Header for your requests.

application/vnd.github.machine-man-preview+json

GitHub Apps are created with a set of permissions. These define what resources the GitHub App can access via the API. For more information, see "Permissions for GitHub Apps."

Metadata permissions

These permissions are enabled for every app. These permissions are a collection of read only endpoints for accessing metadata for various resources that do not leak sensitive private repository information.

Comments

Events

Git

Keys

Members

Permission on "administration"

Branches

Collaborators

Invitations

Keys

Teams

Traffic

Permission on "contents"

Branches

Comments

Git

Import

Releases

Permission on "deployments"

Permission on "issues"

Issues and pull requests are closely related. If your GitHub App has permissions on issues but not on pull requests, these endpoints will be limited to issues. Endpoints that return both issues and pull requests will be filtered. Endpoints that allow operations on both issues and pull requests will be restricted to issues.

Assignees

Comments

Events

Labels

Milestones

Reactions

Permission on "members"

Invitations

Members

Teams

Permission on "organization projects"

Permission on "pages"

Permission on "pull requests"

Issues and pull requests are closely related. If your GitHub App has permissions on pull requests but not on issues, these endpoints will be limited to pull requests. Endpoints that return both pull requests and issues will be filtered. Endpoints that allow operations on both pull requests and issues will be restricted to pull requests.

Assignees

Comments

Events

Labels

Milestones

Requested_reviewers

Reviews

Permission on "repository projects"

Permission on "single file"

Permission on "statuses"