---
title: "Получить каталог прав кабинета"
method: GET
path: "/api/v1/settings/permission-catalog"
tags: ["Settings roles"]
---

# Получить каталог прав кабинета

`GET /api/v1/settings/permission-catalog`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/settings/permission-catalog`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Модули, их разделы и ресурсы и действия со строками прав и подписями на языке запроса. Источник тот же, что у политик движка прав, поэтому строка из каталога что-то открывает, а строку вне каталога сохранение роли отклоняет с кодом 422. Выключенные в кабинете модули тоже показаны — роль можно подготовить заранее.

## Headers

- `X-Tenant` string, required

## Response `200`

Каталог прав

- SettingsPermissionCatalog
  - `modules` SettingsPermissionModule[], required
    - `key` string, required
    - `label` string, required
    - `label_key` string
    - `enabled` boolean, required: Модуль включён в кабинете
    - `actions` SettingsPermissionAction[], required
      - `permission` string, required: Строка права для поля permissions роли
      - `verb` string, required
      - `label` string, required
      - `hint` string
      - `implies` string[], required: Строки, которые ставятся вместе с этой: изменение без просмотра не откроет экран
    - `units` SettingsPermissionUnit[], required
      - `key` string, required: Полный ключ раздела или ресурса: модуль.единица
      - `kind` 'section' | 'resource', required
      - `label` string, required
      - `label_key` string
      - `hint` string
      - `exclusive` boolean, required: Право на модуль единицу не покрывает: выдаётся только своей строкой
      - `technical` boolean, required: Ресурс выдаётся разделом; своей галочки в редакторе нет, но строка допустима
      - `actions` SettingsPermissionAction[], required
        - `permission` string, required: Строка права для поля permissions роли
        - `verb` string, required
        - `label` string, required
        - `hint` string
        - `implies` string[], required: Строки, которые ставятся вместе с этой: изменение без просмотра не откроет экран
    - `record_rules` SettingsPermissionRecordRule[], required
      - `resource` string, required
      - `label` string, required
      - `rules` string[], required
  - `wildcards` string[], required: Строки полного доступа: их выдаёт только администратор кабинета

## Other responses

- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)