---
title: "Retrieve a Permission"
method: GET
path: "/permissions/{id}"
tags: ["Permissions"]
---

# Retrieve a Permission

`GET /permissions/{id}`

Retrieve a single permissions object by unique identifier.

## Path parameters

- `id` integer, required

## Query parameters

- `fields` string[]
- `meta` string

## Response `200`

Successful request

- object
  - `data` Permissions
    - `id` integer — Unique identifier for the permission.
    - `collection` string — What collection this permission applies to.
    - `action` 'create' | 'read' | 'update' | 'delete' — What action this permission applies to.
    - `permissions` object, nullable — JSON structure containing the permissions checks for this permission.
    - `validation` object, nullable — JSON structure containing the validation checks for this permission.
    - `presets` object, nullable — JSON structure containing the preset value for created/updated items.
    - `fields` string[], nullable — CSV of fields that the user is allowed to interact with.
    - `policy` unknown

## Other responses

- `401` — Error: Unauthorized request
- `404` — Error: Not found.

---

[API](https://skmtc.dev/utomic-media/apis/dynamic-api-specification.md) · [All operations](https://skmtc.dev/utomic-media/apis/dynamic-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/utomic-media/dynamic-api-specification/revisions/4a0ccd34700e/schema)