## Storage types

`GET /v1/storages/types`

Calls `disk.storage.getTypes`. Requires `disk` scope. READONLY keys are allowed.

## Examples

### curl — personal key

```bash
curl -X GET 'https://vibecode.bitrix24.com/v1/storages/types' \
  -H 'X-Api-Key: YOUR_API_KEY'
```

### curl — OAuth application

```bash
curl -X GET 'https://vibecode.bitrix24.com/v1/storages/types' \
  -H 'X-Api-Key: YOUR_APP_KEY' \
  -H 'Authorization: Bearer USER_SESSION_TOKEN'
```

### JavaScript — personal key

```javascript
const response = await fetch('https://vibecode.bitrix24.com/v1/storages/types', {
  method: 'GET',
  headers: {"X-Api-Key": "YOUR_API_KEY"},
})
const result = await response.json()
console.log(result)
```

### JavaScript — OAuth application

```javascript
const response = await fetch('https://vibecode.bitrix24.com/v1/storages/types', {
  method: 'GET',
  headers: {"X-Api-Key": "YOUR_APP_KEY", "Authorization": "Bearer USER_SESSION_TOKEN"},
})
const result = await response.json()
console.log(result)
```

## Response fields

| Field | Type | Description |
|---|---|---|
| `success` | boolean | Successful request |
| `data.items` | string[] | Storage types returned by Bitrix24 |

```json
{"success":true,"data":{"items":["user","common","group"]}}
```

`data.items` contains the strings returned by Bitrix24, without platform additions. `user` is personal storage, `common` shared storage, and `group` group storage. Use these values in `entityType` filters for [GET /v1/storages](/docs/entities/storages/list).

The list is fixed in Bitrix24 and incomplete: storage listings may contain other types, for example application storages. Do not treat this dictionary as an exhaustive enum.

## Errors

Example refusal (403):

```json
{"success":false,"error":{"code":"SCOPE_DENIED","message":"The API key does not allow the disk scope."}}
```


| HTTP | Code | Description |
|---|---|---|
| 403 | `SCOPE_DENIED` | Missing disk scope or Bitrix24 denied access |
| 403 | `BITRIX_ACCESS_DENIED` | Missing disk scope or Bitrix24 denied access |
| 422 | `BITRIX_ERROR` | Bitrix24 business refusal or no list returned |
| 422 | `OPERATION_FAILED` | Bitrix24 business refusal or no list returned |

Common refusals: [Errors](/docs/errors).

## See also

- [list](/docs/entities/storages/list)
- [folders](/docs/entities/storages/folders)