## Storage types

`GET /v1/storages/types`

Calls `disk.storage.getTypes`. Requires the `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 | Whether the request succeeded |
| `data.items` | string[] | Storage types returned by Bitrix24 |

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

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

## Response example

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

## Error response example

403 — the key lacks the `disk` scope:

```json
{"success":false,"error":{"code":"SCOPE_DENIED","message":"API key requires \"disk\" scope."}}
```

## Errors

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