Get GitHub Actions permissions for a repository

Gets the GitHub Actions permissions policy for a repository, including whether GitHub Actions is enabled and the actions allowed to run in the repository. You must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `administration` repository permission to use this API.

GET/repos/{owner}/{repo}/actions/permissions

Source: github-v3-rest.json
Revision: f5f067c1e6f6
Active snapshot: 85e53e3d0d65

Request

Path Parameters

owner string required
repo string required

Responses

application/json actions-repository-permissions object

Response

allowed_actions

string< allowed-actions >

optional

The permissions policy that controls the actions that are allowed to run. Can be one of: `all`, `local_only`, or `selected`.

Allowed: "all""local_only""selected"

enabled actions-enabled boolean

required

Whether GitHub Actions is enabled on the repository.

selected_actions_url selected-actions-url string

optional

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

Response Example: 200 application/json

{
  "allowed_actions": "selected",
  "enabled": true,
  "selected_actions_url": "https://api.github.com/repositories/42/actions/permissions/selected-actions"
}

Request configuration

This OpenAPI document does not declare an authentication scheme. Check the API provider's documentation before sending credentials; Manja cannot infer or validate an undocumented scheme.

Common bearer example: Authorization: Bearer YOUR_ACCESS_TOKEN

hostname

Self-hosted Enterprise Server or Enterprise Cloud hostname

protocol

Self-hosted Enterprise Server or Enterprise Cloud protocol

owner *

repo *

Request Sample: Shell / cURL

curl --request GET \
  --url {protocol}://{hostname}/api/v3/repos/{owner}/{repo}/actions/permissions