Skip to content
forgit api docs

Get GitHub Actions permissions for an organization

GET
/orgs/{org}/actions/permissions

Gets the GitHub Actions permissions policy for repositories and allowed actions and reusable workflows in an organization.

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

API method documentation

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “ Path Parameters ”
org
required
string

The organization name. The name is not case sensitive.

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”

Response

Media type application/json
object
enabled_repositories
required

The policy that controls the repositories in the organization that are allowed to run GitHub Actions.

string
Allowed values: all none selected
selected_repositories_url

The API URL to use to get or set the selected repositories that are allowed to run GitHub Actions, when enabled_repositories is set to selected.

string
allowed_actions

The permissions policy that controls the actions and reusable workflows that are allowed to run.

string
Allowed values: all local_only selected
selected_actions_url

The API URL to use to get or set the actions and reusable workflows that are allowed to run, when allowed_actions is set to selected.

string
sha_pinning_required

Whether actions must be pinned to a full-length commit SHA.

boolean
Examples
Example default 
{
  "enabled_repositories": "all",
  "allowed_actions": "selected",
  "selected_actions_url": "https://api.github.com/organizations/42/actions/permissions/selected-actions",
  "sha_pinning_required": true
}