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 saber mais, 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 saber mais, 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.
Organization permissions for "Administration"
Organization permissions for "Custom organization roles"
| Ponto de extremidade | Access | Permissões adicionais |
|---|---|---|
| POST /orgs/{org}/organization-roles | write | |
| PATCH /orgs/{org}/organization-roles/{role_id} | write | |
| DELETE /orgs/{org}/organization-roles/{role_id} | write | |
| GET /orgs/{org}/organization-fine-grained-permissions | read | |
| GET /orgs/{org}/organization-roles | read | |
| GET /orgs/{org}/organization-roles/{role_id} | read |
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 "Organization 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 "Organization private registries"
| Ponto de extremidade | Access | Permissões adicionais |
|---|---|---|
| PATCH /orgs/{org}/private-registries/{secret_name} | write | |
| DELETE /orgs/{org}/private-registries/{secret_name} | write | |
| GET /orgs/{org}/private-registries | read | |
| GET /orgs/{org}/private-registries/public-key | read | |
| GET /orgs/{org}/private-registries/{secret_name} | read |
Organization permissions for "Secrets"
Organization permissions for "Self-hosted runners"
Organization permissions for "Variables"
Organization permissions for "Webhooks"
Repository permissions for "Actions"
Repository permissions for "Administration"
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 "Pull requests"
Repository permissions for "Repository 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 "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 "Private repository invitations"
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 |