---
title: "List Permissions"
method: GET
path: "/permissions"
tags: ["Permissions"]
---

# List Permissions

`GET /permissions`

List all permissions.

## Query parameters

- `fields` string[]
- `limit` integer
- `offset` integer
- `meta` string
- `sort` string[]
- `search` string
- `page` integer

## 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
  - `meta` XMetadata
    - `total_count` integer — Returns the total item count of the collection you're querying.
    - `filter_count` integer — Returns the item count of the collection you're querying, taking the current filter/search parameters into account.

## 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)