fine-grained personal access token
に必要なアクセス許可について
fine-grained personal access token を作成するときに、一連のアクセス許可を付与します。 GitHub AppがAPIを介してアクセスできるリソースが、権限によって決まります。 詳しくは、「個人用アクセス トークンを管理する」を参照してください。
REST API 応答で 受け取る X-Accepted-GitHub-Permissions
ヘッダーで、適切なアクセス許可を選択するための情報が得られます。 このヘッダーは、エンドポイントにアクセスするために必要なアクセス許可を示します。 詳しくは、「REST API のトラブルシューティング」を参照してください。
これらのアクセス許可は、プライベート リソースにアクセスするために必要です。 一部のエンドポイントは、これらのアクセス許可なしでパブリック リソースにアクセスするためにも使用できます。 エンドポイントがアクセス許可なしでパブリック リソースにアクセスできるかどうかを確認するには、そのエンドポイントのドキュメントを参照してください。
一部のエンドポイントは、複数のアクセス許可が必要な場合があります。 他のエンドポイントは、一連のアクセス許可のうち、任意の 1 つのアクセス許可で動作します。 このような場合は、[追加のアクセス許可] 列にチェックマークが含まれます。 エンドポイントを使用するために必要なアクセス許可の詳細については、そのエンドポイントのドキュメントを参照してください。
Business permissions for "Enterprise administration"
Organization permissions for "Administration"
Organization permissions for "Custom properties"
Organization permissions for "Custom repository roles"
Organization permissions for "Events"
エンドポイント | Access | 追加の権限 |
---|---|---|
GET /users/{username}/events/orgs/{org} | read |
Organization permissions for "Members"
Organization permissions for "Organization announcement banners"
エンドポイント | Access | 追加の権限 |
---|---|---|
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"
Organization permissions for "Personal access tokens"
Organization permissions for "Pre-receive hooks"
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 | |
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"
エンドポイント | Access | 追加の権限 |
---|---|---|
PATCH /repos/{owner}/{repo}/properties/values | write |
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 | |
DELETE /user/emails | write | |
GET /user/emails | read | |
GET /user/public_emails | read |
User permissions for "Followers"
エンドポイント | Access | 追加の権限 |
---|---|---|
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"
エンドポイント | Access | 追加の権限 |
---|---|---|
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"
User permissions for "Git SSH keys"
エンドポイント | Access | 追加の権限 |
---|---|---|
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"
エンドポイント | Access | 追加の権限 |
---|---|---|
GET /notifications | read | 複数のアクセス許可が必要な場合や、別のアクセス許可が使用される場合があります。 アクセス許可の詳細については、このエンドポイントのドキュメントを参照してください。 |
User permissions for "Profile"
エンドポイント | Access | 追加の権限 |
---|---|---|
PATCH /user | write | |
POST /user/social_accounts | write | |
DELETE /user/social_accounts | write |
User permissions for "SSH signing keys"
エンドポイント | Access | 追加の権限 |
---|---|---|
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"
エンドポイント | Access | 追加の権限 |
---|---|---|
GET /user/subscriptions | read | |
GET /users/{username}/subscriptions | read |