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 acessar recursos privados com os seguintes pontos de extremidade. Alguns pontos de extremidade também podem ser usados para acessar recursos públicos sem essas permissões.
Alguns pontos de extremidade exigem permissões adicionais. Quando isso ocorrer, a coluna "Permissões adicionais" indicará as outras permissões necessárias para usar o ponto de extremidade.
Business permissions for "Enterprise administration"
Organization permissions for "Administration"
Organization permissions for "Blocking users"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
PUT /orgs/{org}/blocks/{username} | write | ✖️ |
DELETE /orgs/{org}/blocks/{username} | write | ✖️ |
GET /orgs/{org}/blocks | read | ✖️ |
GET /orgs/{org}/blocks/{username} | read | ✖️ |
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 "GitHub Copilot Business"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
GET /orgs/{org}/copilot/billing | write | ✖️ |
GET /orgs/{org}/copilot/billing/seats | write | ✖️ |
POST /orgs/{org}/copilot/billing/selected_teams | write | ✖️ |
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 codespaces secrets"
Organization permissions for "Organization codespaces settings"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
PUT /orgs/{org}/codespaces/access | write | ✖️ |
POST /orgs/{org}/codespaces/access/selected_users | write | ✖️ |
DELETE /orgs/{org}/codespaces/access/selected_users | write | ✖️ |
Organization permissions for "Organization codespaces"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
DELETE /orgs/{org}/members/{username}/codespaces/{codespace_name} | write | |
POST /orgs/{org}/members/{username}/codespaces/{codespace_name}/stop | write | |
GET /orgs/{org}/codespaces | read | |
GET /orgs/{org}/members/{username}/codespaces | read |
Organization permissions for "Organization dependabot secrets"
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"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
POST /orgs/{org}/actions/variables | write | ✖️ |
PATCH /orgs/{org}/actions/variables/{name} | write | ✖️ |
DELETE /orgs/{org}/actions/variables/{name} | write | ✖️ |
PUT /orgs/{org}/actions/variables/{name}/repositories | write | ✖️ |
PUT /orgs/{org}/actions/variables/{name}/repositories/{repository_id} | write | |
GET /orgs/{org}/actions/variables | read | ✖️ |
GET /orgs/{org}/actions/variables/{name} | read | ✖️ |
GET /orgs/{org}/actions/variables/{name}/repositories | read | ✖️ |
Organization permissions for "Webhooks"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
POST /orgs/{org}/hooks | write | ✖️ |
PATCH /orgs/{org}/hooks/{hook_id} | write | ✖️ |
DELETE /orgs/{org}/hooks/{hook_id} | write | ✖️ |
PATCH /orgs/{org}/hooks/{hook_id}/config | write | ✖️ |
POST /orgs/{org}/hooks/{hook_id}/deliveries/{delivery_id}/attempts | write | ✖️ |
POST /orgs/{org}/hooks/{hook_id}/pings | write | ✖️ |
GET /orgs/{org}/hooks | read | ✖️ |
GET /orgs/{org}/hooks/{hook_id} | read | ✖️ |
GET /orgs/{org}/hooks/{hook_id}/config | read | ✖️ |
GET /orgs/{org}/hooks/{hook_id}/deliveries | read | ✖️ |
GET /orgs/{org}/hooks/{hook_id}/deliveries/{delivery_id} | read | ✖️ |
Repository permissions for "Actions"
Repository permissions for "Administration"
Repository permissions for "Checks"
Repository permissions for "Code scanning alerts"
Repository permissions for "Codespaces lifecycle admin"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
POST /orgs/{org}/members/{username}/codespaces/{codespace_name}/stop | write | |
POST /user/codespaces/{codespace_name}/exports | write | ✖️ |
POST /user/codespaces/{codespace_name}/start | write | ✖️ |
POST /user/codespaces/{codespace_name}/stop | write | ✖️ |
GET /user/codespaces/{codespace_name}/exports/{export_id} | read | ✖️ |
Repository permissions for "Codespaces metadata"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
GET /repos/{owner}/{repo}/codespaces/devcontainers | read | ✖️ |
GET /repos/{owner}/{repo}/codespaces/machines | read | ✖️ |
GET /user/codespaces/{codespace_name}/machines | read | ✖️ |
Repository permissions for "Codespaces secrets"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
GET /repos/{owner}/{repo}/codespaces/secrets | write | ✖️ |
GET /repos/{owner}/{repo}/codespaces/secrets/public-key | write | ✖️ |
GET /repos/{owner}/{repo}/codespaces/secrets/{secret_name} | write | ✖️ |
PUT /repos/{owner}/{repo}/codespaces/secrets/{secret_name} | write | |
DELETE /repos/{owner}/{repo}/codespaces/secrets/{secret_name} | write |
Repository permissions for "Codespaces"
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 "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"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
POST /repos/{owner}/{repo}/pages | write | |
PUT /repos/{owner}/{repo}/pages | write | |
DELETE /repos/{owner}/{repo}/pages | write | |
POST /repos/{owner}/{repo}/pages/builds | write | ✖️ |
POST /repos/{owner}/{repo}/pages/deployment | write | ✖️ |
GET /repos/{owner}/{repo}/pages/health | write | |
GET /repos/{owner}/{repo}/pages | read | ✖️ |
GET /repos/{owner}/{repo}/pages/builds | read | ✖️ |
GET /repos/{owner}/{repo}/pages/builds/latest | read | ✖️ |
GET /repos/{owner}/{repo}/pages/builds/{build_id} | read | ✖️ |
Repository permissions for "Projects"
Repository permissions for "Pull requests"
Repository permissions for "Repository security advisories"
Repository permissions for "Secret scanning alerts"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
PATCH /repos/{owner}/{repo}/secret-scanning/alerts/{alert_number} | write | ✖️ |
GET /orgs/{org}/secret-scanning/alerts | read | ✖️ |
GET /repos/{owner}/{repo}/secret-scanning/alerts | read | ✖️ |
GET /repos/{owner}/{repo}/secret-scanning/alerts/{alert_number} | read | ✖️ |
GET /repos/{owner}/{repo}/secret-scanning/alerts/{alert_number}/locations | read | ✖️ |
Repository permissions for "Secrets"
Repository permissions for "Variables"
Repository permissions for "Webhooks"
Repository permissions for "Workflows"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
POST /repos/{owner}/{repo}/git/refs | write | |
PATCH /repos/{owner}/{repo}/git/refs/{ref} | write | |
POST /repos/{owner}/{repo}/releases | write |
User permissions for "Block another user"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
PUT /user/blocks/{username} | write | ✖️ |
DELETE /user/blocks/{username} | write | ✖️ |
GET /user/blocks | read | ✖️ |
GET /user/blocks/{username} | read | ✖️ |
User permissions for "Codespaces user secrets"
User permissions for "Email addresses"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
PATCH /user/email/visibility | write | ✖️ |
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 "Interaction limits"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
PUT /user/interaction-limits | write | ✖️ |
DELETE /user/interaction-limits | write | ✖️ |
GET /user/interaction-limits | read | ✖️ |
User permissions for "Plan"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
GET /users/{username}/settings/billing/actions | read | ✖️ |
GET /users/{username}/settings/billing/packages | read | ✖️ |
GET /users/{username}/settings/billing/shared-storage | read | ✖️ |
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"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
PUT /user/starred/{owner}/{repo} | write | ✖️ |
DELETE /user/starred/{owner}/{repo} | write | ✖️ |
GET /user/starred | read | ✖️ |
GET /user/starred/{owner}/{repo} | read | ✖️ |
GET /users/{username}/starred | read | ✖️ |
User permissions for "Watching"
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
GET /user/subscriptions | read | ✖️ |
GET /users/{username}/subscriptions | read | ✖️ |