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

## Changes

- **2026-05-08** `64c270db1c2e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/rafftechnologies/apis/raff-api/changes/api/v1/permissions/get.md)

---

[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/119e4aec8f63/schema)