---
title: "Get a Permission"
method: GET
path: "/permissions/{permission}"
tags: ["permissions"]
---

# Get a Permission

`GET /permissions/{permission}`

## Request

- Base URL: `https://example.scalr.io/api/iacp/v3`
- URL: `https://example.scalr.io/api/iacp/v3/permissions/{permission}`
- Auth: HTTP bearer

Show details of a specific Scalr IAM Permission.

## Path parameters

- `permission` string, required

## Response `200`

Success.

- PermissionDocument: JSON:API Document. see: https://jsonapi.org/format/#document-structure
  - `data` Permission: The ability to perform an action on an object, enabling the corresponding functionality in the UI and API. e.g. `workspaces:create`, `vcs-providers:read`. The ID of a permission consist of two parts separated with `:` (colon): * Resource type in a plural form. * Action name. Generally the actions are CRUD, but some objects have specific actions, such as `runs:cancel`. If an `*` (asterisk) is used instead of the action name in the permission it means the permission allows all actions for the specified resource type. For example `workspaces:*` allows all actions with workspaces. An asterisk can be also used instead of the resource type. For example permission `*:read` gives read access to all resources. `*:*` - gives access to everything. Use [List Permissions](permissions.html#list-permissions) to obtain all possible permissions.
    - `attributes` object
      - `applicable-scopes` string[]: Scope identities, this permission could be applied to in an [access policy](access-policies.html).
      - `description` string, nullable: Permission description.
    - `id` string
    - `links` object
    - `type` 'permissions', required
  - `included` object[]
  - `meta` object

## Other responses

- `404`: Permission not found or user unauthorized to perform action.
- `4XX`: Client error.
- `5XX`: Server error.

---

[API](https://skmtc.dev/scalr/apis/scalr-iacp-api.md) - [All operations](https://skmtc.dev/scalr/apis/scalr-iacp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scalr/apis/scalr-iacp-api/revisions/d3e1dc85657a?raw)