Get default workflow permissions for an organization

GET

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

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."

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 GET 'https://api.github.com/orgs//actions/permissions/workflow'

Response Example

{
    "can_approve_pull_request_reviews": true,
    "default_workflow_permissions": "read"
}

Request

Path Params

org

string

required

The organization name. The name is not case sensitive.

Responses

🟢200Response

application/json

Body

can_approve_pull_request_reviews

boolean

required

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

default_workflow_permissions

enum<string>

required

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

Allowed values:

readwrite

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

Delete a self-hosted runner group from an organization

Get a self-hosted runner group for an organization