## Уровни доступа к папке

`GET /v1/folders/access-levels`

Возвращает id, code и title с портала. ID отличаются на разных порталах: не хардкодьте их. title — на языке портала. Список содержит только read/edit/full; add тоже доступен для выдачи доступа. Для POST shares используйте access read/add/edit/full, а не id из справочника.

## Параметры

Параметров нет. Скоуп ключа: disk. READONLY-ключ допускается.

## curl — личный ключ

```bash
curl "https://vibecode.bitrix24.tech/v1/folders/access-levels" -H "X-Api-Key: YOUR_API_KEY"
```

## curl — ключ приложения

```bash
curl "https://vibecode.bitrix24.tech/v1/folders/access-levels" -H "X-Api-Key: YOUR_APP_KEY"
```


## JavaScript — личный ключ

```javascript
const response = await fetch("https://vibecode.bitrix24.tech/v1/folders/access-levels", { headers: { "X-Api-Key": "YOUR_API_KEY" } });
const data = await response.json();
```


## JavaScript — ключ приложения

```javascript
const response = await fetch("https://vibecode.bitrix24.tech/v1/folders/access-levels", { headers: { "X-Api-Key": "YOUR_APP_KEY" } });
const data = await response.json();
```

## Ответ

```json
{"success":true,"data":[{"id":79,"code":"disk_access_full","title":"Full access"},{"id":75,"code":"disk_access_edit","title":"Edit"},{"id":71,"code":"disk_access_read","title":"Read"}]}
```

## Поля ответа

| Поле | Тип | Описание |
|---|---|---|
| success | boolean | true |
| data | array | Записи уровней доступа |
| data[].id | integer | ID уровня на этом портале |
| data[].code | string | disk_access_full / disk_access_edit / disk_access_read |
| data[].title | string | На языке портала |

## Ограничения и ошибки

403 SCOPE_DENIED: нет скоупа disk. Бизнес-отказ Б24: 422 BITRIX_ERROR. Некорректный результат: 422 DISK_ACCESS_LEVELS_REFUSED. Транспортные ошибки — штатные отказы V1.

[shares](/docs/entities/folders/shares).

Метод Битрикс24: `disk.rights.getTasks`.