actions

Set default workflow permissions for an enterprise

Sets the default workflow permissions granted to the GITHUB_TOKEN when running workflows in an enterprise, and sets whether GitHub Actions can submit approving pull request reviews. For more information, see "Enforcing a policy for workflow permissions in your enterprise."

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

put/enterprises/{enterprise}/actions/permissions/workflow

Request

  • Base URL: https://api.github.com
  • URL: https://api.github.com/enterprises/{enterprise}/actions/permissions/workflow
  • Auth: none declared

Path parameters

enterprisestring required

The slug version of the enterprise name.

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

Changes

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