# Get GitHub Actions permissions for a repository

From **GitHub v3 REST API**.

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

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.

## Parameters

### `owner`

- Location: path
- Required: true
- Type: `string`

### `repo`

- Location: path
- Required: true
- Type: `string`

## Responses

### `200`

Response

### `application/json`

- Type: `object`

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

```json
{"properties":{"allowed_actions":{"$ref":"#/components/schemas/allowed-actions"},"enabled":{"$ref":"#/components/schemas/actions-enabled"},"selected_actions_url":{"$ref":"#/components/schemas/selected-actions-url"}},"required":["enabled"],"type":"object"}
```

## Request examples

### cURL

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