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.
Organization permissions for "Administration"
Organization permissions for "Blocking users"
엔드포인트 | Access | 추가 권한 |
---|---|---|
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 "Events"
엔드포인트 | Access | 추가 권한 |
---|---|---|
GET /users/{username}/events/orgs/{org} | read | ✖️ |
Organization permissions for "GitHub Copilot for Business"
엔드포인트 | Access | 추가 권한 |
---|---|---|
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 codespaces secrets"
Organization permissions for "Organization codespaces settings"
엔드포인트 | Access | 추가 권한 |
---|---|---|
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"
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"
Organization permissions for "Variables"
Organization permissions for "Webhooks"
Repository permissions for "Actions"
Repository permissions for "Administration"
Repository permissions for "Checks"
Repository permissions for "Code scanning alerts"
Repository permissions for "Codespaces lifecycle admin"
Repository permissions for "Codespaces metadata"
엔드포인트 | Access | 추가 권한 |
---|---|---|
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"
Repository permissions for "Codespaces"
Repository permissions for "Commit statuses"
엔드포인트 | Access | 추가 권한 |
---|---|---|
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"
Repository permissions for "Dependabot secrets"
Repository permissions for "Deployments"
Repository permissions for "Environments"
Repository permissions for "Issues"
Repository permissions for "Metadata"
Repository permissions for "Pages"
Repository permissions for "Projects"
Repository permissions for "Pull requests"
Repository permissions for "Repository security advisories"
Repository permissions for "Secret scanning alerts"
Repository permissions for "Secrets"
Repository permissions for "Variables"
Repository permissions for "Webhooks"
Repository permissions for "Workflows"
엔드포인트 | Access | 추가 권한 |
---|---|---|
POST /repos/{owner}/{repo}/git/refs | write | |
PATCH /repos/{owner}/{repo}/git/refs/{ref} | write |
User permissions for "Block another user"
엔드포인트 | Access | 추가 권한 |
---|---|---|
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"
엔드포인트 | Access | 추가 권한 |
---|---|---|
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"
엔드포인트 | Access | 추가 권한 |
---|---|---|
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"
엔드포인트 | Access | 추가 권한 |
---|---|---|
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"
User permissions for "Git SSH keys"
엔드포인트 | Access | 추가 권한 |
---|---|---|
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"
엔드포인트 | Access | 추가 권한 |
---|---|---|
PUT /user/interaction-limits | write | ✖️ |
DELETE /user/interaction-limits | write | ✖️ |
GET /user/interaction-limits | read | ✖️ |
User permissions for "Plan"
엔드포인트 | Access | 추가 권한 |
---|---|---|
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"
엔드포인트 | Access | 추가 권한 |
---|---|---|
PATCH /user | write | ✖️ |
POST /user/social_accounts | write | ✖️ |
DELETE /user/social_accounts | write | ✖️ |
User permissions for "SSH signing keys"
엔드포인트 | Access | 추가 권한 |
---|---|---|
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"
엔드포인트 | Access | 추가 권한 |
---|---|---|
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"
엔드포인트 | Access | 추가 권한 |
---|---|---|
GET /user/subscriptions | read | ✖️ |
GET /users/{username}/subscriptions | read | ✖️ |