For AI agents: markdown of this page — /docs-content-en/entities/storages/types.md documentation index — /llms.txt

Storage types

GET /v1/storages/types

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

Examples

curl — personal key

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

curl — OAuth application

Terminal
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.

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.

See also