Acerca de los permisos necesarios para los fine-grained personal access token
Cuando se crea un fine-grained personal access token, se le concede un conjunto de permisos. Los permisos definen a qué recursos puede acceder la GitHub App a través de la API. Para obtener más información, vea "Administración de tokens de acceso personal".
Para ayudarle a elegir los permisos correctos, recibirá el encabezado X-Accepted-GitHub-Permissions
en la respuesta de la API de REST. El encabezado le indicará qué permisos son necesarios para acceder al punto de conexión. Para obtener más información, vea «Solución de problemas de API de REST».
Estos permisos son necesarios para acceder a los recursos privados con los siguientes puntos de conexión. Algunos puntos de conexión también se pueden usar para acceder a los recursos públicos sin estos permisos.
Algunos puntos de conexión requieren permisos adicionales. Si este es el caso, la columna "Permisos adicionales" indicará los demás permisos necesarios para usar el punto de conexión.
Business permissions for "Enterprise administration"
Organization permissions for "Administration"
Organization permissions for "Blocking users"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
GET /users/{username}/events/orgs/{org} | read | ✖️ |
Organization permissions for "GitHub Copilot Business"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
PUT /user/interaction-limits | write | ✖️ |
DELETE /user/interaction-limits | write | ✖️ |
GET /user/interaction-limits | read | ✖️ |
User permissions for "Plan"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
PATCH /user | write | ✖️ |
POST /user/social_accounts | write | ✖️ |
DELETE /user/social_accounts | write | ✖️ |
User permissions for "SSH signing keys"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
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"
punto de conexión | Access | Permisos adicionales |
---|---|---|
GET /user/subscriptions | read | ✖️ |
GET /users/{username}/subscriptions | read | ✖️ |