# Get GitHub Actions permissions for an enterprise

From **GitHub v3 REST API**.

`GET /enterprises/{enterprise}/actions/permissions`

Gets the GitHub Actions permissions policy for organizations and allowed actions in an enterprise.

You must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.

## Parameters

### `enterprise`

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

The slug version of the enterprise name. You can also substitute this value with the enterprise id.

## Responses

### `200`

Response

### `application/json`

- Type: `object`

```json
{
  "allowed_actions": "selected",
  "enabled_organizations": "all",
  "selected_actions_url": "https://api.github.com/enterprises/2/actions/permissions/selected-actions"
}
```

```json
{"properties":{"allowed_actions":{"$ref":"#/components/schemas/allowed-actions"},"enabled_organizations":{"$ref":"#/components/schemas/enabled-organizations"},"selected_actions_url":{"$ref":"#/components/schemas/selected-actions-url"},"selected_organizations_url":{"description":"The API URL to use to get or set the selected organizations that are allowed to run GitHub Actions, when `enabled_organizations` is set to `selected`.","type":"string"}},"required":["enabled_organizations"],"type":"object"}
```

## Request examples

### cURL

```shell
curl --request GET \
  --url {protocol}://{hostname}/api/v3/enterprises/{enterprise}/actions/permissions
```