---
title: "Gets available permissions"
method: GET
path: "/api/admin/permissions"
tags: ["Auth"]
---

# Gets available permissions

`GET /api/admin/permissions`

**Enterprise feature**

Returns a list of available permissions

## Response `200`

adminPermissionsSchema

- AdminPermissionsSchema — What kind of permissions are available
  - `permissions` object, required — Returns permissions available at all three levels (root|project|environment)
    - `root` AdminPermissionSchema[] — Permissions available at the root level, i.e. not connected to any specific project or environment
      - `id` integer, required — The identifier for this permission
      - `name` string, required — The name of this permission
      - `displayName` string, required — The name to display in listings of permissions
      - `type` string, required — What level this permission applies to. Either root, project or the name of the environment it applies to
      - `environment` string, nullable — Which environment this permission applies to
    - `project` AdminPermissionSchema[], required — Permissions available at the project level
      - `id` integer, required — The identifier for this permission
      - `name` string, required — The name of this permission
      - `displayName` string, required — The name to display in listings of permissions
      - `type` string, required — What level this permission applies to. Either root, project or the name of the environment it applies to
      - `environment` string, nullable — Which environment this permission applies to
    - `environments` object[], required — A list of environments with available permissions per environment
      - `name` string, required — The name of the environment
      - `permissions` AdminPermissionSchema[], required — Permissions available for this environment
        - `id` integer, required — The identifier for this permission
        - `name` string, required — The name of this permission
        - `displayName` string, required — The name to display in listings of permissions
        - `type` string, required — What level this permission applies to. Either root, project or the name of the environment it applies to
        - `environment` string, nullable — Which environment this permission applies to
  - `version` 1 | 2, required — The api version of this response. A natural increasing number. Only increases if format changes

---

[API](https://skmtc.net/unleash/apis/unleash-api-3.md) · [All operations](https://skmtc.net/unleash/apis/unleash-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unleash/unleash-api-3/revisions/b2c3116e633e/schema)