Permissions required for GitHub Apps

About GitHub App permissions

GitHub Apps are created with a set of permissions. Permissions define what resources the GitHub App can access via the API. For more information, see Choosing permissions for a GitHub App.

To help you choose the correct permissions, you will receive the X-Accepted-GitHub-Permissions header in the REST API response. The header will tell you what permissions are required in order to access the endpoint. For more information, see Troubleshooting the REST API.

These permissions are required to access private resources. Some endpoints can also be used to access public resources without these permissions. To see whether an endpoint can access public resources without a permission, see the documentation for that endpoint.

Some endpoints require more than one permission. Other endpoints work with any one permission from a set of permissions. In these cases, the "Additional permissions" column will include a checkmark. For full details about the permissions that are required to use the endpoint, see the documentation for that endpoint.

Endpoint	Access	Token types
PATCH /enterprises/{enterprise}/properties/schema	write	UAT IAT
PUT /enterprises/{enterprise}/properties/schema/{custom_property_name}	write	UAT IAT
DELETE /enterprises/{enterprise}/properties/schema/{custom_property_name}	write	UAT IAT
GET /enterprises/{enterprise}/properties/schema	read	UAT IAT
GET /enterprises/{enterprise}/properties/schema/{custom_property_name}	read	UAT IAT

Endpoint	Access	Token types
GET /orgs/{org}/insights/api/route-stats/{actor_type}/{actor_id}	read	UAT IAT
GET /orgs/{org}/insights/api/subject-stats	read	UAT IAT
GET /orgs/{org}/insights/api/summary-stats	read	UAT IAT
GET /orgs/{org}/insights/api/summary-stats/users/{user_id}	read	UAT IAT
GET /orgs/{org}/insights/api/summary-stats/{actor_type}/{actor_id}	read	UAT IAT
GET /orgs/{org}/insights/api/time-stats	read	UAT IAT
GET /orgs/{org}/insights/api/time-stats/users/{user_id}	read	UAT IAT
GET /orgs/{org}/insights/api/time-stats/{actor_type}/{actor_id}	read	UAT IAT
GET /orgs/{org}/insights/api/user-stats/{user_id}	read	UAT IAT

Endpoint	Access	Token types	Additional permissions
PATCH /orgs/{org}	write	UAT IAT
DELETE /orgs/{org}	write	UAT IAT
PUT /orgs/{org}/actions/oidc/customization/sub	write	UAT IAT
PUT /orgs/{org}/actions/permissions	write	UAT IAT
PUT /orgs/{org}/actions/permissions/repositories	write	UAT IAT
PUT /orgs/{org}/actions/permissions/repositories/{repository_id}	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
DELETE /orgs/{org}/actions/permissions/repositories/{repository_id}	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
PUT /orgs/{org}/actions/permissions/selected-actions	write	UAT IAT
PUT /orgs/{org}/actions/permissions/workflow	write	UAT IAT
GET /orgs/{org}/bypass-requests/push-rules	write	UAT IAT
GET /orgs/{org}/code-security/configurations	write	UAT IAT
POST /orgs/{org}/code-security/configurations	write	UAT IAT
GET /orgs/{org}/code-security/configurations/defaults	write	UAT IAT
DELETE /orgs/{org}/code-security/configurations/detach	write	UAT IAT
GET /orgs/{org}/code-security/configurations/{configuration_id}	write	UAT IAT
PATCH /orgs/{org}/code-security/configurations/{configuration_id}	write	UAT IAT
DELETE /orgs/{org}/code-security/configurations/{configuration_id}	write	UAT IAT
POST /orgs/{org}/code-security/configurations/{configuration_id}/attach	write	UAT IAT
PUT /orgs/{org}/code-security/configurations/{configuration_id}/defaults	write	UAT IAT
GET /orgs/{org}/code-security/configurations/{configuration_id}/repositories	write	UAT IAT
POST /orgs/{org}/copilot/billing/selected_teams	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
DELETE /orgs/{org}/copilot/billing/selected_teams	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
POST /orgs/{org}/copilot/billing/selected_users	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
DELETE /orgs/{org}/copilot/billing/selected_users	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
DELETE /orgs/{org}/credential-authorizations/{credential_id}	write	UAT IAT
PUT /orgs/{org}/interaction-limits	write	UAT IAT
DELETE /orgs/{org}/interaction-limits	write	UAT IAT
GET /orgs/{org}/rulesets	write	UAT IAT
POST /orgs/{org}/rulesets	write	UAT IAT
GET /orgs/{org}/rulesets/rule-suites	write	UAT IAT
GET /orgs/{org}/rulesets/rule-suites/{rule_suite_id}	write	UAT IAT
GET /orgs/{org}/rulesets/{ruleset_id}	write	UAT IAT
PUT /orgs/{org}/rulesets/{ruleset_id}	write	UAT IAT
DELETE /orgs/{org}/rulesets/{ruleset_id}	write	UAT IAT
PUT /orgs/{org}/security-managers/teams/{team_slug}	write	UAT IAT
DELETE /orgs/{org}/security-managers/teams/{team_slug}	write	UAT IAT
POST /orgs/{org}/{security_product}/{enablement}	write	UAT IAT
GET /enterprise-installation/{enterprise_or_org}/server-statistics	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /organizations/{organization_id}/custom_roles	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /organizations/{org}/settings/billing/usage	read	UAT IAT
GET /orgs/{org}/actions/cache/usage	read	UAT IAT
GET /orgs/{org}/actions/cache/usage-by-repository	read	UAT IAT
GET /orgs/{org}/actions/oidc/customization/sub	read	UAT IAT
GET /orgs/{org}/actions/permissions	read	UAT IAT
GET /orgs/{org}/actions/permissions/repositories	read	UAT IAT
GET /orgs/{org}/actions/permissions/selected-actions	read	UAT IAT
GET /orgs/{org}/actions/permissions/workflow	read	UAT IAT
GET /orgs/{org}/audit-log	read	UAT IAT
GET /orgs/{org}/copilot/billing	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/copilot/billing/seats	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/copilot/metrics	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/copilot/usage	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/credential-authorizations	read	UAT IAT
GET /orgs/{org}/custom-repository-roles	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/custom-repository-roles/{role_id}	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/custom_roles/{role_id}	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/fine_grained_permissions	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/installations	read	UAT IAT
GET /orgs/{org}/interaction-limits	read	UAT IAT
GET /orgs/{org}/members/{username}/copilot	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/repository-fine-grained-permissions	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/security-managers	read	UAT IAT
GET /orgs/{org}/settings/billing/actions	read	UAT IAT
GET /orgs/{org}/settings/billing/advanced-security	read	UAT IAT
GET /orgs/{org}/settings/billing/packages	read	UAT IAT
GET /orgs/{org}/settings/billing/shared-storage	read	UAT IAT
GET /orgs/{org}/team/{team_slug}/copilot/metrics	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/team/{team_slug}/copilot/usage	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.

Endpoint	Access	Token types
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

Endpoint	Access	Token types
POST /orgs/{org}/organization-roles	write	UAT IAT
PATCH /orgs/{org}/organization-roles/{role_id}	write	UAT IAT
DELETE /orgs/{org}/organization-roles/{role_id}	write	UAT IAT
GET /orgs/{org}/organization-fine-grained-permissions	read	UAT IAT
GET /orgs/{org}/organization-roles	read	UAT IAT
GET /orgs/{org}/organization-roles/{role_id}	read	UAT IAT

Endpoint	Access	Token types
PATCH /orgs/{org}/properties/schema	admin	UAT IAT
PUT /orgs/{org}/properties/schema/{custom_property_name}	admin	UAT IAT
DELETE /orgs/{org}/properties/schema/{custom_property_name}	admin	UAT IAT
PATCH /orgs/{org}/properties/values	write	UAT IAT
GET /orgs/{org}/properties/schema	read	UAT IAT
GET /orgs/{org}/properties/schema/{custom_property_name}	read	UAT IAT
GET /orgs/{org}/properties/values	read	UAT IAT

Endpoint	Access	Token types	Additional permissions
POST /orgs/{org}/custom-repository-roles	write	UAT IAT
PATCH /orgs/{org}/custom-repository-roles/{role_id}	write	UAT IAT
DELETE /orgs/{org}/custom-repository-roles/{role_id}	write	UAT IAT
POST /orgs/{org}/custom_roles	write	UAT IAT
PATCH /orgs/{org}/custom_roles/{role_id}	write	UAT IAT
DELETE /orgs/{org}/custom_roles/{role_id}	write	UAT IAT
GET /organizations/{organization_id}/custom_roles	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/custom-repository-roles	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/custom-repository-roles/{role_id}	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/custom_roles/{role_id}	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/fine_grained_permissions	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/repository-fine-grained-permissions	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.

Endpoint	Access	Token types
GET /orgs/{org}/external-group/{group_id}	write	UAT IAT
GET /orgs/{org}/external-groups	write	UAT IAT
POST /orgs/{org}/invitations	write	UAT IAT
DELETE /orgs/{org}/invitations/{invitation_id}	write	UAT IAT
DELETE /orgs/{org}/members/{username}	write	UAT IAT
PUT /orgs/{org}/memberships/{username}	write	UAT IAT
DELETE /orgs/{org}/memberships/{username}	write	UAT IAT
DELETE /orgs/{org}/organization-roles/teams/{team_slug}	write	UAT IAT
PUT /orgs/{org}/organization-roles/teams/{team_slug}/{role_id}	write	UAT IAT
DELETE /orgs/{org}/organization-roles/teams/{team_slug}/{role_id}	write	UAT IAT
DELETE /orgs/{org}/organization-roles/users/{username}	write	UAT IAT
PUT /orgs/{org}/organization-roles/users/{username}/{role_id}	write	UAT IAT
DELETE /orgs/{org}/organization-roles/users/{username}/{role_id}	write	UAT IAT
PUT /orgs/{org}/outside_collaborators/{username}	write	UAT IAT
DELETE /orgs/{org}/outside_collaborators/{username}	write	UAT IAT
PUT /orgs/{org}/public_members/{username}	write	UAT
DELETE /orgs/{org}/public_members/{username}	write	UAT
GET /orgs/{org}/team-sync/groups	write	UAT IAT
POST /orgs/{org}/teams	write	UAT IAT
GET /orgs/{org}/teams/{team_slug}/external-groups	write	UAT IAT
PATCH /orgs/{org}/teams/{team_slug}/external-groups	write	UAT IAT
DELETE /orgs/{org}/teams/{team_slug}/external-groups	write	UAT IAT
POST /scim/v2/organizations/{org}/Users	write	UAT IAT
PUT /scim/v2/organizations/{org}/Users/{scim_user_id}	write	UAT IAT
PATCH /scim/v2/organizations/{org}/Users/{scim_user_id}	write	UAT IAT
DELETE /scim/v2/organizations/{org}/Users/{scim_user_id}	write	UAT IAT
PUT /teams/{team_id}/members/{username}	write	UAT IAT
DELETE /teams/{team_id}/members/{username}	write	UAT IAT
PATCH /user/memberships/orgs/{org}	write	UAT
GET /orgs/{org}/failed_invitations	read	UAT IAT
GET /orgs/{org}/invitations	read	UAT IAT
GET /orgs/{org}/invitations/{invitation_id}/teams	read	UAT IAT
GET /orgs/{org}/members	read	UAT IAT
GET /orgs/{org}/members/{username}	read	UAT IAT
GET /orgs/{org}/memberships/{username}	read	UAT IAT
GET /orgs/{org}/organization-roles/{role_id}/teams	read	UAT IAT
GET /orgs/{org}/organization-roles/{role_id}/users	read	UAT IAT
GET /orgs/{org}/outside_collaborators	read	UAT IAT
GET /orgs/{org}/public_members	read	UAT IAT
GET /orgs/{org}/public_members/{username}	read	UAT IAT
GET /orgs/{org}/teams	read	UAT IAT
GET /scim/v2/organizations/{org}/Users	read	UAT IAT
GET /scim/v2/organizations/{org}/Users/{scim_user_id}	read	UAT IAT
GET /teams/{team_id}/members/{username}	read	UAT IAT
GET /user/memberships/orgs/{org}	read	UAT

Endpoint	Access	Token types
PATCH /orgs/{org}/announcement	write	UAT IAT
DELETE /orgs/{org}/announcement	write	UAT IAT
GET /orgs/{org}/announcement	read	UAT IAT

Endpoint	Access	Token types	Additional permissions
PUT /orgs/{org}/codespaces/secrets/{secret_name}	write	UAT IAT
DELETE /orgs/{org}/codespaces/secrets/{secret_name}	write	UAT IAT
PUT /orgs/{org}/codespaces/secrets/{secret_name}/repositories	write	UAT IAT
PUT /orgs/{org}/codespaces/secrets/{secret_name}/repositories/{repository_id}	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
DELETE /orgs/{org}/codespaces/secrets/{secret_name}/repositories/{repository_id}	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/codespaces/secrets	read	UAT IAT
GET /orgs/{org}/codespaces/secrets/public-key	read	UAT IAT
GET /orgs/{org}/codespaces/secrets/{secret_name}	read	UAT IAT
GET /orgs/{org}/codespaces/secrets/{secret_name}/repositories	read	UAT IAT

Endpoint	Access	Token types
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

Endpoint	Access	Token types	Additional permissions
DELETE /orgs/{org}/members/{username}/codespaces/{codespace_name}	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
POST /orgs/{org}/members/{username}/codespaces/{codespace_name}/stop	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/codespaces	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/members/{username}/codespaces	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.

Endpoint	Access	Token types	Additional permissions
PUT /orgs/{org}/dependabot/secrets/{secret_name}	write	UAT IAT
DELETE /orgs/{org}/dependabot/secrets/{secret_name}	write	UAT IAT
PUT /orgs/{org}/dependabot/secrets/{secret_name}/repositories	write	UAT IAT
PUT /orgs/{org}/dependabot/secrets/{secret_name}/repositories/{repository_id}	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
DELETE /orgs/{org}/dependabot/secrets/{secret_name}/repositories/{repository_id}	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/dependabot/secrets	read	UAT IAT
GET /orgs/{org}/dependabot/secrets/public-key	read	UAT IAT
GET /orgs/{org}/dependabot/secrets/{secret_name}	read	UAT IAT
GET /orgs/{org}/dependabot/secrets/{secret_name}/repositories	read	UAT IAT

Endpoint	Access	Token types
POST /orgs/{org}/personal-access-token-requests	write	UAT IAT
POST /orgs/{org}/personal-access-token-requests/{pat_request_id}	write	UAT IAT
GET /orgs/{org}/personal-access-token-requests	read	UAT IAT
GET /orgs/{org}/personal-access-token-requests/{pat_request_id}/repositories	read	UAT IAT

Endpoint	Access	Token types
POST /orgs/{org}/personal-access-tokens	write	UAT IAT
POST /orgs/{org}/personal-access-tokens/{pat_id}	write	UAT IAT
GET /orgs/{org}/personal-access-tokens	read	UAT IAT
GET /orgs/{org}/personal-access-tokens/{pat_id}/repositories	read	UAT IAT

Endpoint	Access	Token types	Additional permissions
GET /projects/{project_id}/collaborators	admin	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
PUT /projects/{project_id}/collaborators/{username}	admin	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
DELETE /projects/{project_id}/collaborators/{username}	admin	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /projects/{project_id}/collaborators/{username}/permission	admin	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
POST /orgs/{org}/projects	write	UAT IAT
PATCH /projects/columns/cards/{card_id}	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
DELETE /projects/columns/cards/{card_id}	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
POST /projects/columns/cards/{card_id}/moves	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
PATCH /projects/columns/{column_id}	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
DELETE /projects/columns/{column_id}	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
POST /projects/columns/{column_id}/cards	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
POST /projects/columns/{column_id}/moves	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
PATCH /projects/{project_id}	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
DELETE /projects/{project_id}	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
POST /projects/{project_id}/columns	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/projects	read	UAT IAT
GET /projects/columns/cards/{card_id}	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /projects/columns/{column_id}	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /projects/columns/{column_id}/cards	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /projects/{project_id}	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /projects/{project_id}/columns	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.

Endpoint	Access	Token types	Additional permissions
PUT /orgs/{org}/actions/secrets/{secret_name}	write	UAT IAT
DELETE /orgs/{org}/actions/secrets/{secret_name}	write	UAT IAT
PUT /orgs/{org}/actions/secrets/{secret_name}/repositories	write	UAT IAT
PUT /orgs/{org}/actions/secrets/{secret_name}/repositories/{repository_id}	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
DELETE /orgs/{org}/actions/secrets/{secret_name}/repositories/{repository_id}	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/actions/secrets	read	UAT IAT
GET /orgs/{org}/actions/secrets/public-key	read	UAT IAT
GET /orgs/{org}/actions/secrets/{secret_name}	read	UAT IAT
GET /orgs/{org}/actions/secrets/{secret_name}/repositories	read	UAT IAT

Endpoint	Access	Token types	Additional permissions
POST /orgs/{org}/actions/runner-groups	write	UAT IAT
PATCH /orgs/{org}/actions/runner-groups/{runner_group_id}	write	UAT IAT
DELETE /orgs/{org}/actions/runner-groups/{runner_group_id}	write	UAT IAT
PUT /orgs/{org}/actions/runner-groups/{runner_group_id}/repositories	write	UAT IAT
PUT /orgs/{org}/actions/runner-groups/{runner_group_id}/repositories/{repository_id}	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
DELETE /orgs/{org}/actions/runner-groups/{runner_group_id}/repositories/{repository_id}	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
PUT /orgs/{org}/actions/runner-groups/{runner_group_id}/runners	write	UAT IAT
PUT /orgs/{org}/actions/runner-groups/{runner_group_id}/runners/{runner_id}	write	UAT IAT
DELETE /orgs/{org}/actions/runner-groups/{runner_group_id}/runners/{runner_id}	write	UAT IAT
POST /orgs/{org}/actions/runners/generate-jitconfig	write	UAT IAT
POST /orgs/{org}/actions/runners/registration-token	write	UAT IAT
POST /orgs/{org}/actions/runners/remove-token	write	UAT IAT
DELETE /orgs/{org}/actions/runners/{runner_id}	write	UAT IAT
POST /orgs/{org}/actions/runners/{runner_id}/labels	write	UAT IAT
PUT /orgs/{org}/actions/runners/{runner_id}/labels	write	UAT IAT
DELETE /orgs/{org}/actions/runners/{runner_id}/labels	write	UAT IAT
DELETE /orgs/{org}/actions/runners/{runner_id}/labels/{name}	write	UAT IAT
GET /orgs/{org}/actions/runner-groups	read	UAT IAT
GET /orgs/{org}/actions/runner-groups/{runner_group_id}	read	UAT IAT
GET /orgs/{org}/actions/runner-groups/{runner_group_id}/repositories	read	UAT IAT
GET /orgs/{org}/actions/runner-groups/{runner_group_id}/runners	read	UAT IAT
GET /orgs/{org}/actions/runners	read	UAT IAT
GET /orgs/{org}/actions/runners/downloads	read	UAT IAT
GET /orgs/{org}/actions/runners/{runner_id}	read	UAT IAT
GET /orgs/{org}/actions/runners/{runner_id}/labels	read	UAT IAT

Endpoint	Access	Token types	Additional permissions
DELETE /orgs/{org}/teams/{team_slug}/discussions/{discussion_number}/comments/{comment_number}/reactions/{reaction_id}	write	UAT IAT
DELETE /orgs/{org}/teams/{team_slug}/discussions/{discussion_number}/reactions/{reaction_id}	write	UAT IAT

Endpoint	Access	Token types	Additional permissions
POST /orgs/{org}/actions/variables	write	UAT IAT
PATCH /orgs/{org}/actions/variables/{name}	write	UAT IAT
DELETE /orgs/{org}/actions/variables/{name}	write	UAT IAT
PUT /orgs/{org}/actions/variables/{name}/repositories	write	UAT IAT
PUT /orgs/{org}/actions/variables/{name}/repositories/{repository_id}	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
DELETE /orgs/{org}/actions/variables/{name}/repositories/{repository_id}	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /orgs/{org}/actions/variables	read	UAT IAT
GET /orgs/{org}/actions/variables/{name}	read	UAT IAT
GET /orgs/{org}/actions/variables/{name}/repositories	read	UAT IAT

Permissions required for GitHub Apps

In this article

Endpoint	Access	Token types
POST /orgs/{org}/hooks	write	UAT IAT
PATCH /orgs/{org}/hooks/{hook_id}	write	UAT IAT
DELETE /orgs/{org}/hooks/{hook_id}	write	UAT IAT
PATCH /orgs/{org}/hooks/{hook_id}/config	write	UAT IAT
POST /orgs/{org}/hooks/{hook_id}/deliveries/{delivery_id}/attempts	write	UAT IAT
POST /orgs/{org}/hooks/{hook_id}/pings	write	UAT IAT
GET /orgs/{org}/hooks	read	UAT IAT
GET /orgs/{org}/hooks/{hook_id}	read	UAT IAT
GET /orgs/{org}/hooks/{hook_id}/config	read	UAT IAT
GET /orgs/{org}/hooks/{hook_id}/deliveries	read	UAT IAT
GET /orgs/{org}/hooks/{hook_id}/deliveries/{delivery_id}	read	UAT IAT

Endpoint	Access	Token types	Additional permissions
DELETE /repos/{owner}/{repo}/actions/artifacts/{artifact_id}	write	UAT IAT
DELETE /repos/{owner}/{repo}/actions/caches	write	UAT IAT
DELETE /repos/{owner}/{repo}/actions/caches/{cache_id}	write	UAT IAT
POST /repos/{owner}/{repo}/actions/jobs/{job_id}/rerun	write	UAT IAT
PUT /repos/{owner}/{repo}/actions/oidc/customization/sub	write	UAT IAT
DELETE /repos/{owner}/{repo}/actions/runs/{run_id}	write	UAT IAT
POST /repos/{owner}/{repo}/actions/runs/{run_id}/approve	write	UAT IAT
POST /repos/{owner}/{repo}/actions/runs/{run_id}/cancel	write	UAT IAT
POST /repos/{owner}/{repo}/actions/runs/{run_id}/force-cancel	write	UAT IAT
DELETE /repos/{owner}/{repo}/actions/runs/{run_id}/logs	write	UAT IAT
POST /repos/{owner}/{repo}/actions/runs/{run_id}/rerun	write	UAT IAT
POST /repos/{owner}/{repo}/actions/runs/{run_id}/rerun-failed-jobs	write	UAT IAT
PUT /repos/{owner}/{repo}/actions/workflows/{workflow_id}/disable	write	UAT IAT
POST /repos/{owner}/{repo}/actions/workflows/{workflow_id}/dispatches	write	UAT IAT
PUT /repos/{owner}/{repo}/actions/workflows/{workflow_id}/enable	write	UAT IAT
GET /repos/{owner}/{repo}/actions/artifacts	read	UAT IAT
GET /repos/{owner}/{repo}/actions/artifacts/{artifact_id}	read	UAT IAT
GET /repos/{owner}/{repo}/actions/artifacts/{artifact_id}/{archive_format}	read	UAT IAT
GET /repos/{owner}/{repo}/actions/cache/usage	read	UAT IAT
GET /repos/{owner}/{repo}/actions/caches	read	UAT IAT
GET /repos/{owner}/{repo}/actions/jobs/{job_id}	read	UAT IAT
GET /repos/{owner}/{repo}/actions/jobs/{job_id}/logs	read	UAT IAT
GET /repos/{owner}/{repo}/actions/oidc/customization/sub	read	UAT IAT
GET /repos/{owner}/{repo}/actions/runs	read	UAT IAT
GET /repos/{owner}/{repo}/actions/runs/{run_id}	read	UAT IAT
GET /repos/{owner}/{repo}/actions/runs/{run_id}/approvals	read	UAT IAT
GET /repos/{owner}/{repo}/actions/runs/{run_id}/artifacts	read	UAT IAT
GET /repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}	read	UAT IAT
GET /repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}/jobs	read	UAT IAT
GET /repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}/logs	read	UAT IAT
GET /repos/{owner}/{repo}/actions/runs/{run_id}/jobs	read	UAT IAT
GET /repos/{owner}/{repo}/actions/runs/{run_id}/logs	read	UAT IAT
GET /repos/{owner}/{repo}/actions/runs/{run_id}/pending_deployments	read	UAT IAT
POST /repos/{owner}/{repo}/actions/runs/{run_id}/pending_deployments	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /repos/{owner}/{repo}/actions/runs/{run_id}/timing	read	UAT IAT
GET /repos/{owner}/{repo}/actions/workflows	read	UAT IAT
GET /repos/{owner}/{repo}/actions/workflows/{workflow_id}	read	UAT IAT
GET /repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs	read	UAT IAT
GET /repos/{owner}/{repo}/actions/workflows/{workflow_id}/timing	read	UAT IAT
GET /repos/{owner}/{repo}/environments	read	UAT IAT
GET /repos/{owner}/{repo}/environments/{environment_name}	read	UAT IAT
GET /repos/{owner}/{repo}/environments/{environment_name}/deployment-branch-policies	read	UAT IAT
GET /repos/{owner}/{repo}/environments/{environment_name}/deployment-branch-policies/{branch_policy_id}	read	UAT IAT
GET /repos/{owner}/{repo}/environments/{environment_name}/deployment_protection_rules	read	UAT IAT
GET /repos/{owner}/{repo}/environments/{environment_name}/deployment_protection_rules/{protection_rule_id}	read	UAT IAT

Endpoint	Access	Token types	Additional permissions
POST /orgs/{org}/repos	write	UAT IAT
PATCH /repos/{owner}/{repo}	write	UAT IAT
DELETE /repos/{owner}/{repo}	write	UAT IAT
PUT /repos/{owner}/{repo}/actions/permissions	write	UAT IAT
PUT /repos/{owner}/{repo}/actions/permissions/access	write	UAT IAT
PUT /repos/{owner}/{repo}/actions/permissions/selected-actions	write	UAT IAT
PUT /repos/{owner}/{repo}/actions/permissions/workflow	write	UAT IAT
POST /repos/{owner}/{repo}/actions/runners/generate-jitconfig	write	UAT IAT
POST /repos/{owner}/{repo}/actions/runners/registration-token	write	UAT IAT
POST /repos/{owner}/{repo}/actions/runners/remove-token	write	UAT IAT
DELETE /repos/{owner}/{repo}/actions/runners/{runner_id}	write	UAT IAT
POST /repos/{owner}/{repo}/actions/runners/{runner_id}/labels	write	UAT IAT
PUT /repos/{owner}/{repo}/actions/runners/{runner_id}/labels	write	UAT IAT
DELETE /repos/{owner}/{repo}/actions/runners/{runner_id}/labels	write	UAT IAT
DELETE /repos/{owner}/{repo}/actions/runners/{runner_id}/labels/{name}	write	UAT IAT
POST /repos/{owner}/{repo}/autolinks	write	UAT IAT
DELETE /repos/{owner}/{repo}/autolinks/{autolink_id}	write	UAT IAT
PUT /repos/{owner}/{repo}/automated-security-fixes	write	UAT IAT
DELETE /repos/{owner}/{repo}/automated-security-fixes	write	UAT IAT
PUT /repos/{owner}/{repo}/branches/{branch}/protection	write	UAT IAT
DELETE /repos/{owner}/{repo}/branches/{branch}/protection	write	UAT IAT
POST /repos/{owner}/{repo}/branches/{branch}/protection/enforce_admins	write	UAT IAT
DELETE /repos/{owner}/{repo}/branches/{branch}/protection/enforce_admins	write	UAT IAT
PATCH /repos/{owner}/{repo}/branches/{branch}/protection/required_pull_request_reviews	write	UAT IAT
DELETE /repos/{owner}/{repo}/branches/{branch}/protection/required_pull_request_reviews	write	UAT IAT
POST /repos/{owner}/{repo}/branches/{branch}/protection/required_signatures	write	UAT IAT
DELETE /repos/{owner}/{repo}/branches/{branch}/protection/required_signatures	write	UAT IAT
PATCH /repos/{owner}/{repo}/branches/{branch}/protection/required_status_checks	write	UAT IAT
DELETE /repos/{owner}/{repo}/branches/{branch}/protection/required_status_checks	write	UAT IAT
POST /repos/{owner}/{repo}/branches/{branch}/protection/required_status_checks/contexts	write	UAT IAT
PUT /repos/{owner}/{repo}/branches/{branch}/protection/required_status_checks/contexts	write	UAT IAT
DELETE /repos/{owner}/{repo}/branches/{branch}/protection/required_status_checks/contexts	write	UAT IAT
DELETE /repos/{owner}/{repo}/branches/{branch}/protection/restrictions	write	UAT IAT
POST /repos/{owner}/{repo}/branches/{branch}/protection/restrictions/apps	write	UAT IAT
PUT /repos/{owner}/{repo}/branches/{branch}/protection/restrictions/apps	write	UAT IAT
DELETE /repos/{owner}/{repo}/branches/{branch}/protection/restrictions/apps	write	UAT IAT
POST /repos/{owner}/{repo}/branches/{branch}/protection/restrictions/teams	write	UAT IAT
PUT /repos/{owner}/{repo}/branches/{branch}/protection/restrictions/teams	write	UAT IAT
DELETE /repos/{owner}/{repo}/branches/{branch}/protection/restrictions/teams	write	UAT IAT
POST /repos/{owner}/{repo}/branches/{branch}/protection/restrictions/users	write	UAT IAT
PUT /repos/{owner}/{repo}/branches/{branch}/protection/restrictions/users	write	UAT IAT
DELETE /repos/{owner}/{repo}/branches/{branch}/protection/restrictions/users	write	UAT IAT
PATCH /repos/{owner}/{repo}/code-scanning/default-setup	write	UAT IAT
PUT /repos/{owner}/{repo}/collaborators/{username}	write	UAT IAT
DELETE /repos/{owner}/{repo}/collaborators/{username}	write	UAT IAT
PUT /repos/{owner}/{repo}/environments/{environment_name}	write	UAT IAT
DELETE /repos/{owner}/{repo}/environments/{environment_name}	write	UAT IAT
POST /repos/{owner}/{repo}/environments/{environment_name}/deployment-branch-policies	write	UAT IAT
PUT /repos/{owner}/{repo}/environments/{environment_name}/deployment-branch-policies/{branch_policy_id}	write	UAT IAT
DELETE /repos/{owner}/{repo}/environments/{environment_name}/deployment-branch-policies/{branch_policy_id}	write	UAT IAT
POST /repos/{owner}/{repo}/environments/{environment_name}/deployment_protection_rules	write	UAT IAT
DELETE /repos/{owner}/{repo}/environments/{environment_name}/deployment_protection_rules/{protection_rule_id}	write	UAT IAT
POST /repos/{owner}/{repo}/forks	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
PUT /repos/{owner}/{repo}/interaction-limits	write	UAT IAT
DELETE /repos/{owner}/{repo}/interaction-limits	write	UAT IAT
PATCH /repos/{owner}/{repo}/invitations/{invitation_id}	write	UAT IAT
DELETE /repos/{owner}/{repo}/invitations/{invitation_id}	write	UAT IAT
POST /repos/{owner}/{repo}/keys	write	UAT IAT
DELETE /repos/{owner}/{repo}/keys/{key_id}	write	UAT IAT
POST /repos/{owner}/{repo}/pages	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
PUT /repos/{owner}/{repo}/pages	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
DELETE /repos/{owner}/{repo}/pages	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /repos/{owner}/{repo}/pages/health	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
PUT /repos/{owner}/{repo}/private-vulnerability-reporting	write	UAT IAT
DELETE /repos/{owner}/{repo}/private-vulnerability-reporting	write	UAT IAT
POST /repos/{owner}/{repo}/rulesets	write	UAT IAT
GET /repos/{owner}/{repo}/rulesets/rule-suites	write	UAT IAT
GET /repos/{owner}/{repo}/rulesets/rule-suites/{rule_suite_id}	write	UAT IAT
PUT /repos/{owner}/{repo}/rulesets/{ruleset_id}	write	UAT IAT
DELETE /repos/{owner}/{repo}/rulesets/{ruleset_id}	write	UAT IAT
POST /repos/{owner}/{repo}/security-advisories/{ghsa_id}/forks	write	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
POST /repos/{owner}/{repo}/tags/protection	write	UAT IAT
DELETE /repos/{owner}/{repo}/tags/protection/{tag_protection_id}	write	UAT IAT
PUT /repos/{owner}/{repo}/topics	write	UAT IAT
POST /repos/{owner}/{repo}/transfer	write	UAT
PUT /repos/{owner}/{repo}/vulnerability-alerts	write	UAT IAT
DELETE /repos/{owner}/{repo}/vulnerability-alerts	write	UAT IAT
POST /repos/{template_owner}/{template_repo}/generate	write	UAT IAT
POST /user/repos	write	UAT
PATCH /user/repository_invitations/{invitation_id}	write	UAT
DELETE /user/repository_invitations/{invitation_id}	write	UAT
GET /repos/{owner}/{repo}/actions/permissions	read	UAT IAT
GET /repos/{owner}/{repo}/actions/permissions/access	read	UAT IAT
GET /repos/{owner}/{repo}/actions/permissions/selected-actions	read	UAT IAT
GET /repos/{owner}/{repo}/actions/permissions/workflow	read	UAT IAT
GET /repos/{owner}/{repo}/actions/runners	read	UAT IAT
GET /repos/{owner}/{repo}/actions/runners/downloads	read	UAT IAT
GET /repos/{owner}/{repo}/actions/runners/{runner_id}	read	UAT IAT
GET /repos/{owner}/{repo}/actions/runners/{runner_id}/labels	read	UAT IAT
GET /repos/{owner}/{repo}/autolinks	read	UAT IAT
GET /repos/{owner}/{repo}/autolinks/{autolink_id}	read	UAT IAT
GET /repos/{owner}/{repo}/automated-security-fixes	read	UAT IAT
GET /repos/{owner}/{repo}/branches/{branch}/protection	read	UAT IAT
GET /repos/{owner}/{repo}/branches/{branch}/protection/enforce_admins	read	UAT IAT
GET /repos/{owner}/{repo}/branches/{branch}/protection/required_pull_request_reviews	read	UAT IAT
GET /repos/{owner}/{repo}/branches/{branch}/protection/required_signatures	read	UAT IAT
GET /repos/{owner}/{repo}/branches/{branch}/protection/required_status_checks	read	UAT IAT
GET /repos/{owner}/{repo}/branches/{branch}/protection/required_status_checks/contexts	read	UAT IAT
GET /repos/{owner}/{repo}/branches/{branch}/protection/restrictions	read	UAT IAT
GET /repos/{owner}/{repo}/branches/{branch}/protection/restrictions/apps	read	UAT IAT
GET /repos/{owner}/{repo}/branches/{branch}/protection/restrictions/teams	read	UAT IAT
GET /repos/{owner}/{repo}/branches/{branch}/protection/restrictions/users	read	UAT IAT
GET /repos/{owner}/{repo}/code-scanning/default-setup	read	UAT IAT
GET /repos/{owner}/{repo}/code-security-configuration	read	UAT IAT
GET /repos/{owner}/{repo}/environments/{environment_name}/deployment_protection_rules/apps	read	UAT IAT
GET /repos/{owner}/{repo}/interaction-limits	read	UAT IAT
GET /repos/{owner}/{repo}/invitations	read	UAT IAT
GET /repos/{owner}/{repo}/keys	read	UAT IAT
GET /repos/{owner}/{repo}/keys/{key_id}	read	UAT IAT
GET /repos/{owner}/{repo}/tags/protection	read	UAT IAT
GET /repos/{owner}/{repo}/teams	read	UAT IAT
GET /repos/{owner}/{repo}/traffic/clones	read	UAT IAT
GET /repos/{owner}/{repo}/traffic/popular/paths	read	UAT IAT
GET /repos/{owner}/{repo}/traffic/popular/referrers	read	UAT IAT
GET /repos/{owner}/{repo}/traffic/views	read	UAT IAT
GET /repos/{owner}/{repo}/vulnerability-alerts	read	UAT IAT
GET /user/repository_invitations	read	UAT

Endpoint	Access	Token types	Additional permissions
POST /repos/{owner}/{repo}/attestations	write	UAT IAT
GET /repos/{owner}/{repo}/attestations/{subject_digest}	read	UAT IAT

Endpoint	Access	Token types	Additional permissions
POST /repos/{owner}/{repo}/check-runs	write	UAT IAT
PATCH /repos/{owner}/{repo}/check-runs/{check_run_id}	write	UAT IAT
POST /repos/{owner}/{repo}/check-runs/{check_run_id}/rerequest	write	UAT IAT
POST /repos/{owner}/{repo}/check-suites	write	UAT IAT
PATCH /repos/{owner}/{repo}/check-suites/preferences	write	UAT IAT
POST /repos/{owner}/{repo}/check-suites/{check_suite_id}/rerequest	write	UAT IAT
POST /repos/{owner}/{repo}/actions/runs/{run_id}/pending_deployments	read	UAT IAT	Multiple permissions are required, or a different permission may be used. For more information about the permissions, see the documentation for this endpoint.
GET /repos/{owner}/{repo}/check-runs/{check_run_id}	read	UAT IAT
GET /repos/{owner}/{repo}/check-runs/{check_run_id}/annotations	read	UAT IAT
GET /repos/{owner}/{repo}/check-suites/{check_suite_id}	read	UAT IAT
GET /repos/{owner}/{repo}/check-suites/{check_suite_id}/check-runs	read	UAT IAT
GET /repos/{owner}/{repo}/commits/{ref}/check-runs	read	UAT IAT
GET /repos/{owner}/{repo}/commits/{ref}/check-suites	read	UAT IAT

Endpoint	Access	Token types
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

Endpoint	Access	Token types
GET /repos/{owner}/{repo}/codespaces/secrets	write	UAT IAT
GET /repos/{owner}/{repo}/codespaces/secrets/public-key	write	UAT IAT
GET /repos/{owner}/{repo}/codespaces/secrets/{secret_name}	write	UAT IAT
PUT /repos/{owner}/{repo}/codespaces/secrets/{secret_name}	write	UAT IAT
DELETE /repos/{owner}/{repo}/codespaces/secrets/{secret_name}	write	UAT IAT

Endpoint	Access	Token types
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

Endpoint	Access	Token types
PATCH /repos/{owner}/{repo}/dependabot/alerts/{alert_number}	write	UAT IAT
GET /orgs/{org}/dependabot/alerts	read	UAT IAT
GET /repos/{owner}/{repo}/dependabot/alerts	read	UAT IAT
GET /repos/{owner}/{repo}/dependabot/alerts/{alert_number}	read	UAT IAT

Endpoint	Access	Token types
PUT /repos/{owner}/{repo}/dependabot/secrets/{secret_name}	write	UAT IAT
DELETE /repos/{owner}/{repo}/dependabot/secrets/{secret_name}	write	UAT IAT
GET /repos/{owner}/{repo}/dependabot/secrets	read	UAT IAT
GET /repos/{owner}/{repo}/dependabot/secrets/public-key	read	UAT IAT
GET /repos/{owner}/{repo}/dependabot/secrets/{secret_name}	read	UAT IAT