Ao criar um fine-grained personal access token, você concede a ele um conjunto de permissões. As permissões definem quais recursos o 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--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.
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
POST/orgs/{org}/organization-roles | write | |
/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 |
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
/orgs/{org}/properties/schema | admin | |
PUT/orgs/{org}/properties/schema/{custom_property_name} | admin | |
DELETE/orgs/{org}/properties/schema/{custom_property_name} | admin | |
/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 |
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
GET/users/{username}/events/orgs/{org} | read |
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
/orgs/{org}/announcement | write | |
DELETE/orgs/{org}/announcement | write | |
GET/orgs/{org}/announcement | read |
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
POST/orgs/{org}/private-registries | write | |
/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 |
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 |
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 |
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
/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 |
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 |
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 |
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
/repos/{owner}/{repo}/properties/values | write |
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
/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 |
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 |
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
/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 |
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
POST/repos/{owner}/{repo}/actions/variables | write | |
/repos/{owner}/{repo}/actions/variables/{name} | write | |
DELETE/repos/{owner}/{repo}/actions/variables/{name} | write | |
GET/repos/{owner}/{repo}/actions/organization-variables | read | |
GET/repos/{owner}/{repo}/actions/variables | read | |
GET/repos/{owner}/{repo}/actions/variables/{name} | read |
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
POST/user/emails | write | |
DELETE/user/emails | write | |
GET/user/emails | read | |
GET/user/public_emails | read |
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 |
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 |
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
POST/gists | write | |
/gists/{gist_id} | write | |
DELETE/gists/{gist_id} | write | |
POST/gists/{gist_id}/comments | write | |
/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 |
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 |
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
/user | write | |
POST/user/social_accounts | write | |
DELETE/user/social_accounts | write |
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 |
Ponto de extremidade | Access | Permissões adicionais |
---|---|---|
GET/user/subscriptions | read | |
GET/users/{username}/subscriptions | read |