v50

latestOpenAPI 3.0.3MITraw.githubusercontent.com2023-07-147873273.9 MB
actions

Set default workflow permissions for an organization

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

You must authenticate using an access token with the admin:org scope to use this endpoint. GitHub Apps must have the administration organization permission to use this API.

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

Path parameters

orgstring required

The organization name. The name is not case sensitive.

Request body

default_workflow_permissions'read' | 'write'

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

can_approve_pull_request_reviewsboolean

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

Response

Success response