À propos des autorisations nécessaires pour un fine-grained personal access token
Quand vous créez un fine-grained personal access token, vous lui octroyez un ensemble d’autorisations. Les autorisations définissent les ressources auxquelles l’GitHub App peuvent accéder via l’API. Pour plus d’informations, consultez « Gestion de vos jetons d’accès personnels ».
Pour vous aider à choisir les autorisations appropriées, vous recevrez l’en-tête X-Accepted-GitHub-Permissions
dans la réponse de l’API REST. L’en-tête vous indique les autorisations requises pour accéder au point de terminaison. Pour plus d’informations, consultez « Résolution des problèmes de l’API REST ».
Certains points de terminaison nécessitent des autorisations supplémentaires. Dans ce cas, la colonne « Autorisations supplémentaires » indique les autres autorisations requises pour utiliser le point de terminaison.
Business permissions for "Enterprise administration"
Organization permissions for "Administration"
Organization permissions for "Blocking users"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
POST /orgs/{org}/custom-repository-roles | write | ✖️ |
PATCH /orgs/{org}/custom-repository-roles/{role_id} | write | ✖️ |
DELETE /orgs/{org}/custom-repository-roles/{role_id} | write | ✖️ |
POST /orgs/{org}/custom_roles | write | ✖️ |
PATCH /orgs/{org}/custom_roles/{role_id} | write | ✖️ |
DELETE /orgs/{org}/custom_roles/{role_id} | write | ✖️ |
GET /organizations/{organization_id}/custom_roles | read | |
GET /orgs/{org}/custom-repository-roles | read | |
GET /orgs/{org}/custom-repository-roles/{role_id} | read | |
GET /orgs/{org}/custom_roles/{role_id} | read | |
GET /orgs/{org}/fine_grained_permissions | read |
Organization permissions for "Events"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
GET /users/{username}/events/orgs/{org} | read | ✖️ |
Organization permissions for "GitHub Copilot Business"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
DELETE /orgs/{org}/members/{username}/codespaces/{codespace_name} | write | |
POST /repos/{owner}/{repo}/codespaces | write | ✖️ |
GET /repos/{owner}/{repo}/codespaces/new | write | ✖️ |
GET /repos/{owner}/{repo}/codespaces/permissions_check | write | ✖️ |
POST /repos/{owner}/{repo}/pulls/{pull_number}/codespaces | write | ✖️ |
POST /user/codespaces | write | ✖️ |
PATCH /user/codespaces/{codespace_name} | write | ✖️ |
DELETE /user/codespaces/{codespace_name} | write | ✖️ |
POST /user/codespaces/{codespace_name}/publish | write | ✖️ |
GET /orgs/{org}/codespaces | read | |
GET /orgs/{org}/members/{username}/codespaces | read | |
GET /repos/{owner}/{repo}/codespaces | read | ✖️ |
GET /user/codespaces | read | ✖️ |
GET /user/codespaces/{codespace_name} | read | ✖️ |
Repository permissions for "Commit statuses"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
GET /orgs/{org}/security-advisories | write | ✖️ |
POST /repos/{owner}/{repo}/security-advisories | write | ✖️ |
POST /repos/{owner}/{repo}/security-advisories/reports | write | ✖️ |
PATCH /repos/{owner}/{repo}/security-advisories/{ghsa_id} | write | ✖️ |
POST /repos/{owner}/{repo}/security-advisories/{ghsa_id}/cve | write | ✖️ |
GET /repos/{owner}/{repo}/security-advisories | read | ✖️ |
GET /repos/{owner}/{repo}/security-advisories/{ghsa_id} | read | ✖️ |
POST /repos/{owner}/{repo}/security-advisories/{ghsa_id}/forks | read |
Repository permissions for "Secret scanning alerts"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
PUT /user/interaction-limits | write | ✖️ |
DELETE /user/interaction-limits | write | ✖️ |
GET /user/interaction-limits | read | ✖️ |
User permissions for "Plan"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
PATCH /user | write | ✖️ |
POST /user/social_accounts | write | ✖️ |
DELETE /user/social_accounts | write | ✖️ |
User permissions for "SSH signing keys"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
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"
Point de terminaison | Access | Autorisations supplémentaires |
---|---|---|
GET /user/subscriptions | read | ✖️ |
GET /users/{username}/subscriptions | read | ✖️ |