关于 GitHub App 权限
GitHub Apps 是用一组权限创建的。 权限定义了 GitHub App 可以通过 API 访问哪些资源。 有关详细信息,请参阅“为 GitHub Apps 选择权限”。
为帮助正确选择权限,在 REST API 响应中将会收到 X-Accepted-GitHub-Permissions
标头。 标头将会提示访问端点所需的权限。 有关详细信息,请参阅“REST API 故障排除”。
需要拥有这些权限才能访问专用资源。 某些端点也可以用来访问不具有这些权限的公共资源。 若要查看端点是否可以在没有权限的情况下访问公共资源,请参阅该端点的文档。
某些端点需要多个权限。 其他端点使用一组权限中的任何一个权限。 在这些情况下,“其他权限”列将包含复选标记。 有关使用端点所需的权限的完整详细信息,请参阅该端点的文档。
Business permissions for "Enterprise administration"
Organization permissions for "API Insights"
Organization permissions for "Administration"
Organization permissions for "Blocking users"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
PUT /orgs/{org}/blocks/{username} | write | UAT IAT | |
DELETE /orgs/{org}/blocks/{username} | write | UAT IAT | |
GET /orgs/{org}/blocks | read | UAT IAT | |
GET /orgs/{org}/blocks/{username} | read | UAT IAT |
Organization permissions for "Custom organization roles"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
GET /orgs/{org}/organization-roles | read | UAT IAT | |
GET /orgs/{org}/organization-roles/{role_id} | read | UAT IAT |
Organization permissions for "Custom properties"
Organization permissions for "Events"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
GET /users/{username}/events/orgs/{org} | read | UAT |
Organization permissions for "GitHub Copilot Business"
Organization permissions for "Members"
Organization permissions for "Organization codespaces secrets"
Organization permissions for "Organization codespaces settings"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
PUT /orgs/{org}/codespaces/access | write | UAT IAT | |
POST /orgs/{org}/codespaces/access/selected_users | write | UAT IAT | |
DELETE /orgs/{org}/codespaces/access/selected_users | write | UAT IAT |
Organization permissions for "Organization codespaces"
Organization permissions for "Organization dependabot secrets"
Organization permissions for "Personal access token requests"
Organization permissions for "Personal access tokens"
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 "Attestations"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
POST /repos/{owner}/{repo}/attestations | write | UAT IAT | |
GET /repos/{owner}/{repo}/attestations/{subject_digest} | read | UAT IAT |
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 | UAT IAT | |
GET /repos/{owner}/{repo}/codespaces/machines | read | UAT IAT | |
GET /user/codespaces/{codespace_name}/machines | read | UAT |
Repository permissions for "Codespaces secrets"
Repository permissions for "Codespaces"
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 "Custom properties"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
PATCH /repos/{owner}/{repo}/properties/values | write | UAT IAT |