actions

Get default workflow permissions for an organization

Gets the default workflow permissions granted to the GITHUB_TOKEN when running workflows in an organization, as well as whether GitHub Actions can submit approving pull request reviews. For more information, see "Setting the permissions of the GITHUB_TOKEN for your organization."

OAuth tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

get/orgs/{org}/actions/permissions/workflow

Request

  • Base URL: http://HOSTNAME/api/v3
  • URL: http://HOSTNAME/api/v3/orgs/{org}/actions/permissions/workflow
  • Auth: none declared

Path parameters

orgstring required

The organization name. The name is not case sensitive.

Response

Response

default_workflow_permissions'read' | 'write' required

The default workflow permissions granted to the GITHUB_TOKEN when running workflows.

can_approve_pull_request_reviewsboolean required

Whether GitHub Actions can approve pull requests. Enabling this can be a security risk.

Changes

No recorded changes to this operation across all 50 revisions of this API.