关于 GitHub App 权限
GitHub Apps 是用一组权限创建的。 权限定义了 GitHub App 可以通过 API 访问哪些资源。 有关详细信息,请参阅“为 GitHub Apps 选择权限”。
需要拥有这些权限才能访问专用资源。 某些端点也可以用来访问不具有这些权限的公共资源。 若要查看端点是否可以在没有权限的情况下访问公共资源,请参阅该端点的文档。
某些端点需要多个权限。 其他端点使用一组权限中的任何一个权限。 在这些情况下,“其他权限”列将包含复选标记。 有关使用端点所需的权限的完整详细信息,请参阅该端点的文档。
Business permissions for "Enterprise administration"
Organization permissions for "Administration"
Organization permissions for "Custom repository roles"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
GET /organizations/{organization_id}/custom_roles | read | UAT IAT | 需要多个权限,或者可以使用不同的权限。 有关权限的更多信息,请参阅此终结点的文档。 |
Organization permissions for "Events"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
GET /users/{username}/events/orgs/{org} | read | UAT |
Organization permissions for "Members"
Organization permissions for "Organization announcement banners"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
PATCH /orgs/{org}/announcement | write | UAT IAT | |
DELETE /orgs/{org}/announcement | write | UAT IAT | |
GET /orgs/{org}/announcement | read | UAT IAT |
Organization permissions for "Organization dependabot secrets"
Organization permissions for "Pre-receive hooks"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
DELETE /orgs/{org}/pre-receive-hooks/{pre_receive_hook_id} | write | UAT IAT | |
GET /orgs/{org}/pre-receive-hooks | read | UAT IAT | |
GET /orgs/{org}/pre-receive-hooks/{pre_receive_hook_id} | read | UAT IAT |
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 "Commit statuses"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
POST /repos/{owner}/{repo}/statuses/{sha} | write | UAT IAT | |
GET /repos/{owner}/{repo}/commits/{ref}/status | read | UAT IAT | |
GET /repos/{owner}/{repo}/commits/{ref}/statuses | read | UAT IAT |
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 "Pre-receive hooks"
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"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
POST /user/emails | write | UAT | |
DELETE /user/emails | write | UAT | |
GET /user/emails | read | UAT | |
GET /user/public_emails | read | UAT |
User permissions for "Followers"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
PUT /user/following/{username} | write | UAT | |
DELETE /user/following/{username} | write | UAT | |
GET /user/followers | read | UAT | |
GET /user/following | read | UAT | |
GET /user/following/{username} | read | UAT |
User permissions for "GPG keys"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
POST /user/gpg_keys | write | UAT | |
DELETE /user/gpg_keys/{gpg_key_id} | write | UAT | |
GET /user/gpg_keys | read | UAT | |
GET /user/gpg_keys/{gpg_key_id} | read | UAT |
User permissions for "Gists"
User permissions for "Git SSH keys"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
POST /user/keys | write | UAT | |
DELETE /user/keys/{key_id} | write | UAT | |
GET /user/keys | read | UAT | |
GET /user/keys/{key_id} | read | UAT | |
GET /users/{username}/keys | read | UAT IAT |
User permissions for "Notifications"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
GET /notifications | read | UAT | 需要多个权限,或者可以使用不同的权限。 有关权限的更多信息,请参阅此终结点的文档。 |
User permissions for "Profile"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
PATCH /user | write | UAT |
User permissions for "SSH signing keys"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
POST /user/ssh_signing_keys | write | UAT | |
DELETE /user/ssh_signing_keys/{ssh_signing_key_id} | write | UAT | |
GET /user/ssh_signing_keys | read | UAT | |
GET /user/ssh_signing_keys/{ssh_signing_key_id} | read | UAT |
User permissions for "Starring"
User permissions for "Watching"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
GET /user/subscriptions | read | UAT | |
GET /users/{username}/subscriptions | read | UAT IAT |