## Folder access levels

`GET /v1/folders/access-levels`

Returns id, code and title from the portal. IDs differ between portals: never hardcode them. title is in the portal language. Only read/edit/full are listed; add also exists for sharing. Use access read/add/edit/full in POST shares, not an id from this directory.

## Parameters

No parameters. Key scope: disk. READONLY keys allowed.

## curl — personal key

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

## curl — application key

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


## JavaScript — personal key

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


## JavaScript — application key

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

## Response

```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"}]}
```

## Response fields

| Field | Type | Description |
|---|---|---|
| success | boolean | true |
| data | array | Access level records |
| data[].id | integer | Portal-specific id |
| data[].code | string | disk_access_full / disk_access_edit / disk_access_read |
| data[].title | string | Portal language |

## Limitations and errors

403 SCOPE_DENIED: missing disk scope. Native business refusal: 422 BITRIX_ERROR. Invalid result: 422 DISK_ACCESS_LEVELS_REFUSED. Transport failures use the standard V1 errors.

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

Bitrix24 method: `disk.rights.getTasks`.