Informationen zu GitHub App-Berechtigungen
GitHub Apps werden mit Berechtigungen erstellt. Berechtigungen definieren, auf welche Ressourcen die GitHub App über die API zugreifen kann. Weitere Informationen findest du unter Auswählen von Berechtigungen für eine GitHub-App.
Sie erhalten den X-Accepted-GitHub-Permissions
-Header in der REST-API-Antwort, damit Sie die richtigen Berechtigungen auswählen können. Der Header teilt Ihnen mit, welche Berechtigungen erforderlich sind, um auf den Endpunkt zuzugreifen. Weitere Informationen findest du unter Problembehandlung der REST-API.
Diese Berechtigungen sind für den Zugriff auf private Ressourcen erforderlich. Einige Endpunkte können auch ohne diese Berechtigungen für den Zugriff auf öffentliche Ressourcen verwendet werden. Informationen dazu, ob ein Endpunkt ohne Berechtigung auf öffentliche Ressourcen zugreifen kann, finden Sie in der Dokumentation für den betreffenden Endpunkt.
Bei manchen Endpunkte ist mehr als eine Berechtigung erforderlich. Andere Endpunkte arbeiten mit einer beliebigen Berechtigung aus einer Gruppe von Berechtigungen. In diesen Fällen ist die Spalte „Zusätzliche Berechtigungen“ mit ein Häkchen versehen. Ausführliche Informationen zu den für die Verwendung des Endpunkts erforderlichen Berechtigungen finden Sie in der Dokumentation für den betreffenden Endpunkt.
Business permissions for "Enterprise administration"
Organization permissions for "Administration"
Organization permissions for "Custom properties"
Organization permissions for "Custom repository roles"
Organization permissions for "Events"
Endpunkt | Access | Tokentypen | Zusätzliche Berechtigungen |
---|---|---|---|
GET /users/{username}/events/orgs/{org} | read | UAT |
Organization permissions for "Members"
Organization permissions for "Organization announcement banners"
Endpunkt | Access | Tokentypen | Zusätzliche Berechtigungen |
---|---|---|---|
PATCH /orgs/{org}/announcement | write | UAT IAT | |
DELETE /orgs/{org}/announcement | write | UAT IAT | |
GET /orgs/{org}/announcement | read | UAT IAT |
Organization permissions for "Organization dependabot secrets"
Organization permissions for "Personal access token requests"
Endpunkt | Access | Tokentypen | Zusätzliche Berechtigungen |
---|---|---|---|
POST /orgs/{org}/personal-access-token-requests | write | UAT IAT | |
POST /orgs/{org}/personal-access-token-requests/{pat_request_id} | write | UAT IAT | |
GET /orgs/{org}/personal-access-token-requests | read | UAT IAT | |
GET /orgs/{org}/personal-access-token-requests/{pat_request_id}/repositories | read | UAT IAT |
Organization permissions for "Personal access tokens"
Endpunkt | Access | Tokentypen | Zusätzliche Berechtigungen |
---|---|---|---|
POST /orgs/{org}/personal-access-tokens | write | UAT IAT | |
POST /orgs/{org}/personal-access-tokens/{pat_id} | write | UAT IAT | |
GET /orgs/{org}/personal-access-tokens | read | UAT IAT | |
GET /orgs/{org}/personal-access-tokens/{pat_id}/repositories | read | UAT IAT |
Organization permissions for "Pre-receive hooks"
Endpunkt | Access | Tokentypen | Zusätzliche Berechtigungen |
---|---|---|---|
PATCH /orgs/{org}/pre-receive-hooks/{pre_receive_hook_id} | write | UAT IAT | |
DELETE /orgs/{org}/pre-receive-hooks/{pre_receive_hook_id} | write | UAT IAT | |
GET /orgs/{org}/pre-receive-hooks | read | UAT IAT | |
GET /orgs/{org}/pre-receive-hooks/{pre_receive_hook_id} | read | UAT IAT |
Organization permissions for "Projects"
Organization permissions for "Secrets"
Organization permissions for "Self-hosted runners"
Organization permissions for "Team discussions"
Endpunkt | Access | Tokentypen | Zusätzliche Berechtigungen |
---|---|---|---|
DELETE /orgs/{org}/teams/{team_slug}/discussions/{discussion_number}/comments/{comment_number}/reactions/{reaction_id} | write | UAT IAT | |
DELETE /orgs/{org}/teams/{team_slug}/discussions/{discussion_number}/reactions/{reaction_id} | write | UAT IAT |
Organization permissions for "Variables"
Organization permissions for "Webhooks"
Repository permissions for "Actions"
Repository permissions for "Administration"
Repository permissions for "Checks"
Repository permissions for "Code scanning alerts"
Repository permissions for "Commit statuses"
Endpunkt | Access | Tokentypen | Zusätzliche Berechtigungen |
---|---|---|---|
POST /repos/{owner}/{repo}/statuses/{sha} | write | UAT IAT | |
GET /repos/{owner}/{repo}/commits/{ref}/status | read | UAT IAT | |
GET /repos/{owner}/{repo}/commits/{ref}/statuses | read | UAT IAT |
Repository permissions for "Contents"
Repository permissions for "Custom properties"
Endpunkt | Access | Tokentypen | Zusätzliche Berechtigungen |
---|---|---|---|
PATCH /repos/{owner}/{repo}/properties/values | write | UAT IAT |
Repository permissions for "Dependabot alerts"
Endpunkt | Access | Tokentypen | Zusätzliche Berechtigungen |
---|---|---|---|
PATCH /repos/{owner}/{repo}/dependabot/alerts/{alert_number} | write | UAT IAT | |
GET /orgs/{org}/dependabot/alerts | read | UAT IAT | |
GET /repos/{owner}/{repo}/dependabot/alerts | read | UAT IAT | |
GET /repos/{owner}/{repo}/dependabot/alerts/{alert_number} | read | UAT IAT |
Repository permissions for "Dependabot secrets"
Repository permissions for "Deployments"
Repository permissions for "Environments"
Repository permissions for "Issues"
Repository permissions for "Metadata"
Repository permissions for "Pages"
Repository permissions for "Pre-receive hooks"
Endpunkt | Access | Tokentypen | Zusätzliche Berechtigungen |
---|---|---|---|
PATCH /repos/{owner}/{repo}/pre-receive-hooks/{pre_receive_hook_id} | write | UAT IAT | |
DELETE /repos/{owner}/{repo}/pre-receive-hooks/{pre_receive_hook_id} | write | UAT IAT | |
GET /repos/{owner}/{repo}/pre-receive-hooks | read | UAT IAT | |
GET /repos/{owner}/{repo}/pre-receive-hooks/{pre_receive_hook_id} | read | UAT IAT |
Repository permissions for "Projects"
Repository permissions for "Pull requests"
Repository permissions for "Secret scanning alerts"
Repository permissions for "Secrets"
Repository permissions for "Variables"
Repository permissions for "Webhooks"
Repository permissions for "Workflows"
User permissions for "Email addresses"
Endpunkt | Access | Tokentypen | Zusätzliche Berechtigungen |
---|---|---|---|
POST /user/emails | write | UAT | |
DELETE /user/emails | write | UAT | |
GET /user/emails | read | UAT | |
GET /user/public_emails | read | UAT |
User permissions for "Followers"
Endpunkt | Access | Tokentypen | Zusätzliche Berechtigungen |
---|---|---|---|
PUT /user/following/{username} | write | UAT | |
DELETE /user/following/{username} | write | UAT | |
GET /user/followers | read | UAT | |
GET /user/following | read | UAT | |
GET /user/following/{username} | read | UAT |
User permissions for "GPG keys"
Endpunkt | Access | Tokentypen | Zusätzliche Berechtigungen |
---|---|---|---|
POST /user/gpg_keys | write | UAT | |
DELETE /user/gpg_keys/{gpg_key_id} | write | UAT | |
GET /user/gpg_keys | read | UAT | |
GET /user/gpg_keys/{gpg_key_id} | read | UAT |
User permissions for "Gists"
Endpunkt | Access | Tokentypen | Zusätzliche Berechtigungen |
---|---|---|---|
POST /gists | write | UAT | |
PATCH /gists/{gist_id} | write | UAT | |
DELETE /gists/{gist_id} | write | UAT | |
POST /gists/{gist_id}/comments | write | UAT | |
PATCH /gists/{gist_id}/comments/{comment_id} | write | UAT | |
DELETE /gists/{gist_id}/comments/{comment_id} | write | UAT | |
POST /gists/{gist_id}/forks | write | UAT | |
PUT /gists/{gist_id}/star | write | UAT | |
DELETE /gists/{gist_id}/star | write | UAT |
User permissions for "Git SSH keys"
Endpunkt | Access | Tokentypen | Zusätzliche Berechtigungen |
---|---|---|---|
POST /user/keys | write | UAT | |
DELETE /user/keys/{key_id} | write | UAT | |
GET /user/keys | read | UAT | |
GET /user/keys/{key_id} | read | UAT | |
GET /users/{username}/keys | read | UAT IAT |
User permissions for "Notifications"
Endpunkt | Access | Tokentypen | Zusätzliche Berechtigungen |
---|---|---|---|
GET /notifications | read | UAT | Es sind mehrere Berechtigungen erforderlich, oder es kann eine andere Berechtigung verwendet werden. Weitere Informationen über Berechtigungen findest du in der Dokumentation zu diesem Endpunkt. |
User permissions for "Profile"
Endpunkt | Access | Tokentypen | Zusätzliche Berechtigungen |
---|---|---|---|
PATCH /user | write | UAT | |
POST /user/social_accounts | write | UAT | |
DELETE /user/social_accounts | write | UAT |
User permissions for "SSH signing keys"
Endpunkt | Access | Tokentypen | Zusätzliche Berechtigungen |
---|---|---|---|
POST /user/ssh_signing_keys | write | UAT | |
DELETE /user/ssh_signing_keys/{ssh_signing_key_id} | write | UAT | |
GET /user/ssh_signing_keys | read | UAT | |
GET /user/ssh_signing_keys/{ssh_signing_key_id} | read | UAT |
User permissions for "Starring"
User permissions for "Watching"
Endpunkt | Access | Tokentypen | Zusätzliche Berechtigungen |
---|---|---|---|
GET /user/subscriptions | read | UAT | |
GET /users/{username}/subscriptions | read | UAT IAT |