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

# List permissions

`GET /api/v1/permissions`

List the full catalog of permission strings recognized by the role system. Use this to discover valid values for the `permissions` array on [Create Role](#tag/Roles/operation/createRole) and [Update Role](#tag/Roles/operation/updateRole).

Requires authentication, but no specific permission — any valid API key can read the catalog. The catalog is the same for every account.

## Query parameters

- `scope` 'account' | 'project'

## Response `200`

List of permissions

- object
  - `success` boolean
  - `data` Permission[]
    - `name` string, required
    - `description` string
    - `scope` 'account' | 'project', required
    - `category` string, required

---

[API](https://skmtc.dev/rafftechnologies/apis/raff-api.md) · [All operations](https://skmtc.dev/rafftechnologies/apis/raff-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rafftechnologies/raff-api/revisions/2f4df56be77c/schema)