Sobre as permissões de GitHub App
GitHub Apps são criadas com um conjunto de permissões. As permissões definem quais recursos o GitHub App pode acessar através da API. Para obter mais informações, confira "Escolhendo permissões para um Aplicativo GitHub".
Para ajudar você a escolher as permissões corretas, você receberá o cabeçalho X-Accepted-GitHub-Permissions
na resposta da API REST. O cabeçalho informará quais permissões são necessárias para acessar o ponto de extremidade. Para obter mais informações, confira "Solucionar problemas do API REST".
Essas permissões são necessárias para a obtenção de acesso a recursos privados. Alguns pontos de extremidade também podem ser usados para acessar recursos públicos sem essas permissões. Para visualizar se um ponto de extremidade pode ter acesso a recursos públicos sem a necessidade de permissões, confira a documentação para esse ponto de extremidade.
Alguns pontos de extremidade requerem mais de uma permissão. Outros pontos de extremidade funcionam com qualquer permissão de um conjunto de permissões. Nesses casos, a coluna “Permissões adicionais” incluirá uma marca de verificação. Para obter detalhes completos sobre as permissões necessárias para usar o ponto de extremidade, confira a documentação para esse ponto de extremidade.
Business permissions for "Enterprise administration"
Organization permissions for "Administration"
Organization permissions for "Blocking users"
Ponto de extremidade | Access | Tipos de token | Permissões adicionais |
---|---|---|---|
PUT /orgs/{org}/blocks/{username} | write | UAT IAT | |
DELETE /orgs/{org}/blocks/{username} | write | UAT IAT | |
GET /orgs/{org}/blocks | read | UAT IAT | |
GET /orgs/{org}/blocks/{username} | read | UAT IAT |
Organization permissions for "Custom organization roles"
Ponto de extremidade | Access | Tipos de token | Permissões adicionais |
---|---|---|---|
POST /orgs/{org}/organization-roles | write | UAT IAT | |
PATCH /orgs/{org}/organization-roles/{role_id} | write | UAT IAT | |
DELETE /orgs/{org}/organization-roles/{role_id} | write | UAT IAT | |
GET /orgs/{org}/organization-fine-grained-permissions | read | UAT IAT | |
GET /orgs/{org}/organization-roles | read | UAT IAT | |
GET /orgs/{org}/organization-roles/{role_id} | read | UAT IAT |
Organization permissions for "Custom properties"
Ponto de extremidade | Access | Tipos de token | Permissões adicionais |
---|---|---|---|
PATCH /orgs/{org}/properties/schema | admin | UAT IAT | |
PUT /orgs/{org}/properties/schema/{custom_property_name} | admin | UAT IAT | |
DELETE /orgs/{org}/properties/schema/{custom_property_name} | admin | UAT IAT | |
PATCH /orgs/{org}/properties/values | write | UAT IAT | |
GET /orgs/{org}/properties/schema | read | UAT IAT | |
GET /orgs/{org}/properties/schema/{custom_property_name} | read | UAT IAT | |
GET /orgs/{org}/properties/values | read | UAT IAT |
Organization permissions for "Custom repository roles"
Organization permissions for "Events"
Ponto de extremidade | Access | Tipos de token | Permissões adicionais |
---|---|---|---|
GET /users/{username}/events/orgs/{org} | read | UAT |
Organization permissions for "GitHub Copilot Business"
Organization permissions for "Members"
Organization permissions for "Organization announcement banners"
Ponto de extremidade | Access | Tipos de token | Permissões adicionais |
---|---|---|---|
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 codespaces secrets"
Organization permissions for "Organization codespaces settings"
Ponto de extremidade | Access | Tipos de token | Permissões adicionais |
---|---|---|---|
PUT /orgs/{org}/codespaces/access | write | UAT IAT | |
POST /orgs/{org}/codespaces/access/selected_users | write | UAT IAT | |
DELETE /orgs/{org}/codespaces/access/selected_users | write | UAT IAT |
Organization permissions for "Organization codespaces"
Organization permissions for "Organization dependabot secrets"
Organization permissions for "Personal access token requests"
Ponto de extremidade | Access | Tipos de token | Permissões adicionais |
---|---|---|---|
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"
Ponto de extremidade | Access | Tipos de token | Permissões adicionais |
---|---|---|---|
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 "Projects"
Organization permissions for "Secrets"
Organization permissions for "Self-hosted runners"
Organization permissions for "Team discussions"
Ponto de extremidade | Access | Tipos de token | Permissões adicionais |
---|---|---|---|
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 "Attestations"
Ponto de extremidade | Access | Tipos de token | Permissões adicionais |
---|---|---|---|
POST /repos/{owner}/{repo}/attestations | write | UAT IAT | |
GET /repos/{owner}/{repo}/attestations/{subject_digest} | read | UAT IAT |
Repository permissions for "Checks"
Repository permissions for "Code scanning alerts"
Repository permissions for "Codespaces lifecycle admin"
Repository permissions for "Codespaces metadata"
Ponto de extremidade | Access | Tipos de token | Permissões adicionais |
---|---|---|---|
GET /repos/{owner}/{repo}/codespaces/devcontainers | read | UAT IAT | |
GET /repos/{owner}/{repo}/codespaces/machines | read | UAT IAT | |
GET /user/codespaces/{codespace_name}/machines | read | UAT |
Repository permissions for "Codespaces secrets"
Ponto de extremidade | Access | Tipos de token | Permissões adicionais |
---|---|---|---|
GET /repos/{owner}/{repo}/codespaces/secrets | write | UAT IAT | |
GET /repos/{owner}/{repo}/codespaces/secrets/public-key | write | UAT IAT | |
GET /repos/{owner}/{repo}/codespaces/secrets/{secret_name} | write | UAT IAT | |
PUT /repos/{owner}/{repo}/codespaces/secrets/{secret_name} | write | UAT IAT | |
DELETE /repos/{owner}/{repo}/codespaces/secrets/{secret_name} | write | UAT IAT |
Repository permissions for "Codespaces"
Repository permissions for "Commit statuses"
Ponto de extremidade | Access | Tipos de token | Permissões adicionais |
---|---|---|---|
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"
Ponto de extremidade | Access | Tipos de token | Permissões adicionais |
---|---|---|---|
PATCH /repos/{owner}/{repo}/properties/values | write | UAT IAT |
Repository permissions for "Dependabot alerts"
Ponto de extremidade | Access | Tipos de token | Permissões adicionais |
---|---|---|---|
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"
Ponto de extremidade | Access | Tipos de token | Permissões adicionais |
---|---|---|---|
PUT /repos/{owner}/{repo}/dependabot/secrets/{secret_name} | write | UAT IAT | |
DELETE /repos/{owner}/{repo}/dependabot/secrets/{secret_name} | write | UAT IAT | |
GET /repos/{owner}/{repo}/dependabot/secrets | read | UAT IAT | |
GET /repos/{owner}/{repo}/dependabot/secrets/public-key | read | UAT IAT | |
GET /repos/{owner}/{repo}/dependabot/secrets/{secret_name} | read | UAT IAT |