---
title: "GET /v2/roles/permission-sets"
method: GET
path: "/v2/roles/permission-sets"
tags: ["roles"]
---

# GET /v2/roles/permission-sets

`GET /v2/roles/permission-sets`

Get a list of available Permission Sets that can be assigned to roles

## Headers

- `cloudzero-test-key` string

## Response `200`

Successful Operation

- object
  - `permission_sets` PermissionSetSummary[]
    - `id` string — Unique identifier (category_id/action)
    - `name` string — Display name
    - `description` string — Description of the permission set
    - `category_id` string — Category grouping
    - `action` string — Action type (read, write, etc.)
    - `depends_on` string[] — IDs of permission sets this one depends on
    - `required` boolean — Whether this permission set is required for all roles

## Other responses

- `403` — Forbidden

---

[API](https://skmtc.net/cloudzero/apis/cloudzero-api-v2-resources.md) · [All operations](https://skmtc.net/cloudzero/apis/cloudzero-api-v2-resources/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudzero/cloudzero-api-v2-resources/versions/fd805a0e75e5/schema)