Set default workflow permissions for an organization

PUT

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

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.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.github.com/orgs//actions/permissions/workflow' \
--header 'Content-Type: application/json' \
--data-raw '{
    "can_approve_pull_request_reviews": true,
    "default_workflow_permissions": "read"
}'

Response Example

{}

Request

Path Params

org

string

required

The organization name. The name is not case sensitive.

Body Params application/json

can_approve_pull_request_reviews

boolean

optional

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

default_workflow_permissions

enum<string>

optional

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

Allowed values:

readwrite

Examples

Responses

🟢204Success response

application/json

Body

object {0}

Modified at 2023-08-15 02:59:24

Get a self-hosted runner group for an organization

Update a self-hosted runner group for an organization