Сведения о разрешениях, необходимых для fine-grained personal access token
При создании fine-grained personal access tokenвы предоставляете ему набор разрешений. Разрешения определяют то, к каким ресурсам GitHub App имеет доступ через API. Дополнительные сведения см. в разделе Управление личными маркерами доступа.
Чтобы выбрать правильные разрешения, вы получите X-Accepted-GitHub-Permissions
заголовок в ответе REST API. Заголовок сообщит вам, какие разрешения необходимы для доступа к конечной точке. Дополнительные сведения см. в разделе Устранение неполадок с REST API.
Эти разрешения необходимы для доступа к частным ресурсам. Некоторые конечные точки также можно использовать для доступа к общедоступным ресурсам без этих разрешений. Сведения о том, может ли конечная точка получить доступ к общедоступным ресурсам без разрешения, см. в документации по этой конечной точке.
Для некоторых конечных точек требуется несколько разрешений. Другие конечные точки работают с любым разрешением из набора разрешений. В этих случаях столбец "Дополнительные разрешения" будет содержать проверка марк. Полные сведения о разрешениях, необходимых для использования конечной точки, см. в документации по этой конечной точке.
Business permissions for "Enterprise administration"
Organization permissions for "Administration"
Organization permissions for "Custom properties"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
GET /users/{username}/events/orgs/{org} | read |
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 dependabot secrets"
Organization permissions for "Personal access token requests"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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 |
Organization permissions for "Personal access tokens"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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 |
Organization permissions for "Pre-receive hooks"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
PATCH /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 |
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"
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 "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 "Custom properties"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
PATCH /repos/{owner}/{repo}/properties/values | write |
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"
Repository permissions for "Deployments"
Repository permissions for "Environments"
Repository permissions for "Issues"
Repository permissions for "Metadata"
Repository permissions for "Pages"
Repository permissions for "Pre-receive hooks"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
PATCH /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 |
Repository permissions for "Projects"
Repository permissions for "Pull requests"
Repository permissions for "Secret scanning alerts"
Repository permissions for "Secrets"
Repository permissions for "Variables"
Repository permissions for "Webhooks"
Repository permissions for "Workflows"
User permissions for "Email addresses"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
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 "Notifications"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
GET /notifications | 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"
User permissions for "Watching"
Конечная точка | Открыть | Дополнительные разрешения |
---|---|---|
GET /user/subscriptions | read | |
GET /users/{username}/subscriptions | read |