---
title: "List permission sets"
method: GET
path: "/api/permission-sets"
tags: ["Permission Sets"]
---

# List permission sets

`GET /api/permission-sets`

Users that have the global permission Manage Permission Sets get the full details, including the available operations.
### Required Permissions

- **Global (At least 1 of the following):** Manage Permission Sets, Manage User Global Permissions

## Query parameters

- `type` PermissionSetType[]

## Response `200`

Returns the list of permission sets

- PermissionSetModel[]
  - `id` string, required — The ID of the permission set.
  - `type` 'Global' | 'Dataset' | 'CustomEntity' | 'ManualRedactionProject' — The type discriminator for Permission Sets which determines the kinds of operations available to that Permission Set.<p>Possible values:</p> <ul> <li><b>Global</b>: Tonic-wide operations</li> <li><b>Dataset</b>: Dataset-specific operations</li> <li><b>CustomEntity</b>: Custom entity-specific operations</li> <li><b>ManualRedactionProject</b>: Manual redaction project operations</li> </ul>
  - `name` string, required — The name of the permission set.
  - `isBuiltIn` boolean — Whether the permission set is built-in.
  - `isDefault` boolean — Whether the permission set is the default permission set for its type.
  - `isDisabled` boolean — Whether the permission set is disabled.
  - `lastModifiedDate` Instant — A point in time represented as an ISO 8601 timestamp string.
  - `operations` integer[], nullable — The operations of the permission set. Only included for users with `Manage Permission Sets` permission.
  - `createdDate` Instant — A point in time represented as an ISO 8601 timestamp string.
  - `lastModifiedByUserId` string, nullable — The ID of the user who last modified the permission set. Only included for users with `Manage Permission Sets` permission.

## Other responses

- `400` — Invalid filter parameters
- `500` — Internal server error

---

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