Sobre as permissões necessárias para o fine-grained personal access token
Ao criar um fine-grained personal access token, você concede a ele 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 "Gerenciar seus tokens de acesso pessoal".
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 "Custom properties"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
PATCH /orgs/{org}/properties/schema | admin | |
PUT /orgs/{org}/properties/schema/{custom_property_name} | admin | |
DELETE /orgs/{org}/properties/schema/{custom_property_name} | admin | |
PATCH /orgs/{org}/properties/values | write | |
GET /orgs/{org}/properties/schema | read | |
GET /orgs/{org}/properties/schema/{custom_property_name} | read | |
GET /orgs/{org}/properties/values | read |
Organization permissions for "Custom repository roles"
Organization permissions for "Events"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
GET /users/{username}/events/orgs/{org} | read |
Organization permissions for "Members"
Organization permissions for "Organization announcement banners"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
PATCH /orgs/{org}/announcement | write | |
DELETE /orgs/{org}/announcement | write | |
GET /orgs/{org}/announcement | read |
Organization permissions for "Organization dependabot secrets"
Organization permissions for "Personal access token requests"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
POST /orgs/{org}/personal-access-token-requests | write | |
POST /orgs/{org}/personal-access-token-requests/{pat_request_id} | write | |
GET /orgs/{org}/personal-access-token-requests | read | |
GET /orgs/{org}/personal-access-token-requests/{pat_request_id}/repositories | read |
Organization permissions for "Personal access tokens"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
POST /orgs/{org}/personal-access-tokens | write | |
POST /orgs/{org}/personal-access-tokens/{pat_id} | write | |
GET /orgs/{org}/personal-access-tokens | read | |
GET /orgs/{org}/personal-access-tokens/{pat_id}/repositories | read |
Organization permissions for "Pre-receive hooks"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
PATCH /orgs/{org}/pre-receive-hooks/{pre_receive_hook_id} | write | |
DELETE /orgs/{org}/pre-receive-hooks/{pre_receive_hook_id} | write | |
GET /orgs/{org}/pre-receive-hooks | read | |
GET /orgs/{org}/pre-receive-hooks/{pre_receive_hook_id} | read |
Organization permissions for "Projects"
Organization permissions for "Secrets"
Organization permissions for "Self-hosted runners"
Organization permissions for "Team discussions"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
DELETE /orgs/{org}/teams/{team_slug}/discussions/{discussion_number}/comments/{comment_number}/reactions/{reaction_id} | write | |
DELETE /orgs/{org}/teams/{team_slug}/discussions/{discussion_number}/reactions/{reaction_id} | write |
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"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
POST /repos/{owner}/{repo}/statuses/{sha} | write | |
GET /repos/{owner}/{repo}/commits/{ref}/status | read | |
GET /repos/{owner}/{repo}/commits/{ref}/statuses | read |
Repository permissions for "Contents"
Repository permissions for "Custom properties"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
PATCH /repos/{owner}/{repo}/properties/values | write |
Repository permissions for "Dependabot alerts"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
PATCH /repos/{owner}/{repo}/dependabot/alerts/{alert_number} | write | |
GET /orgs/{org}/dependabot/alerts | read | |
GET /repos/{owner}/{repo}/dependabot/alerts | read | |
GET /repos/{owner}/{repo}/dependabot/alerts/{alert_number} | read |
Repository permissions for "Dependabot secrets"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
PUT /repos/{owner}/{repo}/dependabot/secrets/{secret_name} | write | |
DELETE /repos/{owner}/{repo}/dependabot/secrets/{secret_name} | write | |
GET /repos/{owner}/{repo}/dependabot/secrets | read | |
GET /repos/{owner}/{repo}/dependabot/secrets/public-key | read | |
GET /repos/{owner}/{repo}/dependabot/secrets/{secret_name} | read |
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"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
PATCH /repos/{owner}/{repo}/pre-receive-hooks/{pre_receive_hook_id} | write | |
DELETE /repos/{owner}/{repo}/pre-receive-hooks/{pre_receive_hook_id} | write | |
GET /repos/{owner}/{repo}/pre-receive-hooks | read | |
GET /repos/{owner}/{repo}/pre-receive-hooks/{pre_receive_hook_id} | read |
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"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
POST /user/emails | write | |
DELETE /user/emails | write | |
GET /user/emails | read | |
GET /user/public_emails | read |
User permissions for "Followers"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
PUT /user/following/{username} | write | |
DELETE /user/following/{username} | write | |
GET /user/followers | read | |
GET /user/following | read | |
GET /user/following/{username} | read |
User permissions for "GPG keys"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
POST /user/gpg_keys | write | |
DELETE /user/gpg_keys/{gpg_key_id} | write | |
GET /user/gpg_keys | read | |
GET /user/gpg_keys/{gpg_key_id} | read |
User permissions for "Gists"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
POST /gists | write | |
PATCH /gists/{gist_id} | write | |
DELETE /gists/{gist_id} | write | |
POST /gists/{gist_id}/comments | write | |
PATCH /gists/{gist_id}/comments/{comment_id} | write | |
DELETE /gists/{gist_id}/comments/{comment_id} | write | |
POST /gists/{gist_id}/forks | write | |
PUT /gists/{gist_id}/star | write | |
DELETE /gists/{gist_id}/star | write |
User permissions for "Git SSH keys"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
POST /user/keys | write | |
DELETE /user/keys/{key_id} | write | |
GET /user/keys | read | |
GET /user/keys/{key_id} | read | |
GET /users/{username}/keys | read |
User permissions for "Notifications"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
GET /notifications | read | Várias permissões são necessárias ou uma permissão diferente pode ser usada. Para obter mais informações sobre as permissões, consulte a documentação deste ponto de extremidade. |
User permissions for "Profile"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
PATCH /user | write | |
POST /user/social_accounts | write | |
DELETE /user/social_accounts | write |
User permissions for "SSH signing keys"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
POST /user/ssh_signing_keys | write | |
DELETE /user/ssh_signing_keys/{ssh_signing_key_id} | write | |
GET /user/ssh_signing_keys | read | |
GET /user/ssh_signing_keys/{ssh_signing_key_id} | read |
User permissions for "Starring"
User permissions for "Watching"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
GET /user/subscriptions | read | |
GET /users/{username}/subscriptions | read |