GitHub Appの権限について
GitHub Appsは、一連の権限を付けて作成されます。 GitHub AppがAPIを介してアクセスできるリソースが、権限によって決まります。 詳しくは、「GitHub アプリのアクセス許可を選択する」を参照してください。
REST API 応答で 受け取る X-Accepted-GitHub-Permissions
ヘッダーで、適切なアクセス許可を選択するための情報が得られます。 このヘッダーは、エンドポイントにアクセスするために必要なアクセス許可を示します。 詳しくは、「REST API のトラブルシューティング」を参照してください。
これらのアクセス許可は、プライベート リソースにアクセスするために必要です。 一部のエンドポイントは、これらのアクセス許可なしでパブリック リソースにアクセスするためにも使用できます。 エンドポイントがアクセス許可なしでパブリック リソースにアクセスできるかどうかを確認するには、そのエンドポイントのドキュメントを参照してください。
一部のエンドポイントは、複数のアクセス許可が必要な場合があります。 他のエンドポイントは、一連のアクセス許可のうち、任意の 1 つのアクセス許可で動作します。 このような場合は、[追加のアクセス許可] 列にチェックマークが含まれます。 エンドポイントを使用するために必要なアクセス許可の詳細については、そのエンドポイントのドキュメントを参照してください。
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 |