About permissions required for fine-grained personal access token
When you create a fine-grained personal access token, you grant it a set of permissions. Permissions define what resources the GitHub App can access via the API. For more information, see "Managing your personal access tokens."
To help you choose the correct permissions, you will receive the X-Accepted-GitHub-Permissions
header in the REST API response. The header will tell you what permissions are required in order to access the endpoint. For more information, see "Troubleshooting."
Some endpoints require additional permissions. When this is the case, the "Additional permissions" column will indicate the other permissions that are required to use the endpoint.
Business permissions for "Enterprise administration"
Organization permissions for "Administration"
Organization permissions for "Blocking users"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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 repository roles"
Organization permissions for "Events"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
GET /users/{username}/events/orgs/{org} | read | ✖️ |
Organization permissions for "GitHub Copilot for Business"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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 | ✖️ |
Repository permissions for "Secret scanning alerts"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
POST /repos/{owner}/{repo}/git/refs | write | |
PATCH /repos/{owner}/{repo}/git/refs/{ref} | write |
User permissions for "Block another user"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
PUT /user/interaction-limits | write | ✖️ |
DELETE /user/interaction-limits | write | ✖️ |
GET /user/interaction-limits | read | ✖️ |
User permissions for "Plan"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
PATCH /user | write | ✖️ |
POST /user/social_accounts | write | ✖️ |
DELETE /user/social_accounts | write | ✖️ |
User permissions for "SSH signing keys"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
GET /user/subscriptions | read | ✖️ |
GET /users/{username}/subscriptions | read | ✖️ |