关于精细化个人访问令牌所需的权限
创建精细化个人访问令牌时，会为其授予一组权限。权限定义了 GitHub 应用可以通过 API 访问哪些资源。有关详细信息，请参阅管理个人访问令牌。
为了帮助您选择正确的权限，您将在 REST API 响应中收到 X-Accepted-GitHub-Permissions 标头。该标头将告诉您访问终结点需要哪些权限。有关详细信息，请参阅 REST API 故障排除。
这些权限是访问私有资源所必需的。某些终结点也可以在没有这些权限的情况下用于访问公共资源。要查看终结点是否可以在没有权限的情况下访问公共资源，请参阅该终结点的文档。
某些终结点需要多项权限。其他终结点则可以使用权限集中的任何一项权限。在这些情况下，“附加权限”列将包含一个复选标记。有关使用该终结点所需的权限的完整详情，请参阅该终结点的文档。
针对“API 洞察”的组织权限
针对“管理”的组织权限
针对“屏蔽用户”的组织权限
| 终结点 | 访问权限 | 其他权限 |
|---|---|---|
| PUT /orgs/{org}/blocks/{username} | 写入 | |
| DELETE /orgs/{org}/blocks/{username} | 写入 | |
| GET /orgs/{org}/blocks | 读取 | |
| GET /orgs/{org}/blocks/{username} | 读取 |
针对“活动”的组织权限
针对“Copilot 代理设置”的组织权限
针对“Copilot 内容排除”的组织权限
| 终结点 | 访问权限 | 其他权限 |
|---|---|---|
| PUT /orgs/{org}/copilot/content_exclusion | 写入 | |
| GET /orgs/{org}/copilot/content_exclusion | 读取 |
针对“自定义组织角色”的组织权限
| 终结点 | 访问权限 | 其他权限 |
|---|---|---|
| GET /orgs/{org}/organization-roles | 读取 | |
| GET /orgs/{org}/organization-roles/{role_id} | 读取 |
针对“自定义属性”的组织权限
针对“事件”的组织权限
| 终结点 | 访问权限 | 其他权限 |
|---|---|---|
| GET /users/{username}/events/orgs/{org} | 读取 |
针对“GitHub Copilot Business”的组织权限
针对“托管运行程序自定义镜像”的组织权限
针对“问题字段”的组织权限
| 终结点 | 访问权限 | 其他权限 |
|---|---|---|
| POST /orgs/{org}/issue-fields | 写入 | |
| PATCH /orgs/{org}/issue-fields/{issue_field_id} | 写入 | |
| DELETE /orgs/{org}/issue-fields/{issue_field_id} | 写入 | |
| GET /orgs/{org}/issue-fields | 读取 |
针对“问题类型”的组织权限
| 终结点 | 访问权限 | 其他权限 |
|---|---|---|
| POST /orgs/{org}/issue-types | 写入 | |
| PUT /orgs/{org}/issue-types/{issue_type_id} | 写入 | |
| DELETE /orgs/{org}/issue-types/{issue_type_id} | 写入 | |
| GET /orgs/{org}/issue-types | 读取 |
针对“成员”的组织权限
针对“网络配置”的组织权限
针对“组织 Copilot 指标”的组织权限
针对“组织 codespaces 机密”的组织权限
针对“组织 codespaces 设置”的组织权限
| 终结点 | 访问权限 | 其他权限 |
|---|---|---|
| PUT /orgs/{org}/codespaces/access | 写入 | |
| POST /orgs/{org}/codespaces/access/selected_users | 写入 | |
| DELETE /orgs/{org}/codespaces/access/selected_users | 写入 |
针对“组织 codespaces”的组织权限
针对“组织 dependabot 机密”的组织权限
针对“组织私有注册表”的组织权限
针对“项目”的组织权限
针对“机密”的组织权限
针对“自托管运行程序”的组织权限
针对“变量”的组织权限
针对“Webhooks”的组织权限
针对“Actions”的存储库权限
针对“管理”的存储库权限
针对“构件元数据”的存储库权限
针对“证明”的存储库权限
针对“代码扫描警报”的存储库权限
针对“Codespaces 生命周期管理”的存储库权限
针对“Codespaces 元数据”的存储库权限
| 终结点 | 访问权限 | 其他权限 |
|---|---|---|
| GET /repos/{owner}/{repo}/codespaces/devcontainers | 读取 | |
| GET /repos/{owner}/{repo}/codespaces/machines | 读取 | |
| GET /user/codespaces/{codespace_name}/machines | 读取 |
针对“Codespaces 机密”的存储库权限
针对“Codespaces”的存储库权限
针对“提交状态”的存储库权限
| 终结点 | 访问权限 | 其他权限 |
|---|---|---|
| POST /repos/{owner}/{repo}/statuses/{sha} | 写入 | |
| GET /repos/{owner}/{repo}/commits/{ref}/status | 读取 | |
| GET /repos/{owner}/{repo}/commits/{ref}/statuses | 读取 |
针对“内容”的存储库权限
针对“Dependabot 警报”的存储库权限
针对“Dependabot 机密”的存储库权限
针对“部署”的存储库权限
针对“环境”的存储库权限
针对“问题”的存储库权限
针对“元数据”的存储库权限
针对“页面”的存储库权限
针对“拉取请求”的存储库权限
针对“存储库安全公告”的存储库权限
针对“密钥扫描警报”的存储库权限
针对“机密”的存储库权限
针对“变量”的存储库权限
针对“Webhooks”的存储库权限
针对“工作流”的存储库权限
针对“屏蔽另一用户”的用户权限
| 终结点 | 访问权限 | 其他权限 |
|---|---|---|
| PUT /user/blocks/{username} | 写入 | |
| DELETE /user/blocks/{username} | 写入 | |
| GET /user/blocks | 读取 | |
| GET /user/blocks/{username} | 读取 |
针对“Codespaces 用户机密”的用户权限
针对“电子邮件地址”的用户权限
| 终结点 | 访问权限 | 其他权限 |
|---|---|---|
| PATCH /user/email/visibility | 写入 | |
| POST /user/emails | 写入 | |
| DELETE /user/emails | 写入 | |
| GET /user/emails | 读取 | |
| GET /user/public_emails | 读取 |
针对“关注者”的用户权限
| 终结点 | 访问权限 | 其他权限 |
|---|---|---|
| PUT /user/following/{username} | 写入 | |
| DELETE /user/following/{username} | 写入 | |
| GET /user/followers | 读取 | |
| GET /user/following | 读取 | |
| GET /user/following/{username} | 读取 |
针对“GPG 密钥”的用户权限
| 终结点 | 访问权限 | 其他权限 |
|---|---|---|
| POST /user/gpg_keys | 写入 | |
| DELETE /user/gpg_keys/{gpg_key_id} | 写入 | |
| GET /user/gpg_keys | 读取 | |
| GET /user/gpg_keys/{gpg_key_id} | 读取 |
针对“Gists”的用户权限
针对“Git SSH 密钥”的用户权限
| 终结点 | 访问权限 | 其他权限 |
|---|---|---|
| POST /user/keys | 写入 | |
| DELETE /user/keys/{key_id} | 写入 | |
| GET /user/keys | 读取 | |
| GET /user/keys/{key_id} | 读取 | |
| GET /users/{username}/keys | 读取 |
针对“互动限制”的用户权限
| 终结点 | 访问权限 | 其他权限 |
|---|---|---|
| PUT /user/interaction-limits | 写入 | |
| DELETE /user/interaction-limits | 写入 | |
| GET /user/interaction-limits | 读取 |
针对“计划”的用户权限
| 终结点 | 访问权限 | 其他权限 |
|---|---|---|
| GET /users/{username}/settings/billing/premium_request/usage | 读取 | |
| GET /users/{username}/settings/billing/usage | 读取 | |
| GET /users/{username}/settings/billing/usage/summary | 读取 |
针对“私有存储库邀请”的用户权限
| 终结点 | 访问权限 | 其他权限 |
|---|---|---|
| GET /repos/{owner}/{repo}/invitations | 读取 | 需要多项权限，或者可以使用不同的权限。有关权限的详细信息，请参阅此终结点的文档。 |
针对“SSH 签名密钥”的用户权限
| 终结点 | 访问权限 | 其他权限 |
|---|---|---|
| POST /user/ssh_signing_keys | 写入 | |
| DELETE /user/ssh_signing_keys/{ssh_signing_key_id} | 写入 | |
| GET /user/ssh_signing_keys | 读取 | |
| GET /user/ssh_signing_keys/{ssh_signing_key_id} | 读取 |