Папки

Управление папками на диске Битрикс24: список содержимого, создание, переименование и удаление. Папки хранятся внутри хранилищ и образуют дерево вложенности.

Битрикс24 API: disk.folder.* Скоуп: disk

Создать папку

POST /v1/folders

Создаёт новую папку внутри указанной родительской папки. Тело передаётся плоско, без обёртки fields.

Поля запроса (body)

Поле Битрикс24 Тип Обяз. Описание
name NAME string да Имя новой папки
parentId PARENT_ID number да ID родительской папки. Корневая папка хранилища — rootFolderId из GET /v1/storages

Поле code доступно только для чтения — при создании не сохраняется, его передача возвращает 400 READONLY_FIELD.

Примеры

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

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/folders" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Документы","parentId":27}'

curl — OAuth-приложение

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/folders" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Документы","parentId":27}'

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/folders', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ name: 'Документы', parentId: 27 }),
})

const { success, data } = await res.json()
console.log('Создана папка:', data.id)

JavaScript — OAuth-приложение

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/folders', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ name: 'Документы', parentId: 27 }),
})

const { success, data } = await res.json()

Поля ответа

Поле Тип Описание
success boolean Всегда true при успехе
data object Объект созданной папки. Все поля — см. Поля папки

URL карточки папки в Битрикс24 строится из id: https://<portal>.bitrix24.ru/company/personal/user/1/disk/path/<имя>/. <portal> — домен портала. Доступ ограничен правами сотрудника в Битрикс24.

Пример ответа

JSON 
{
  "success": true,
  "data": {
    "id": 9301,
    "name": "Документы",
    "code": null,
    "storageId": 1,
    "type": "folder",
    "realObjectId": 9301,
    "parentId": 27,
    "deletedType": 0,
    "createdAt": "2026-06-25T12:10:00.000Z",
    "updatedAt": "2026-06-25T12:10:00.000Z",
    "deletedAt": null,
    "createdBy": 1,
    "updatedBy": 1,
    "deletedBy": 0,
    "detailUrl": "https://<portal>.bitrix24.ru/company/personal/user/1/disk/path/Загруженные файлы/Документы"
  }
}

Пример ответа при ошибке

400 — не передано обязательное поле name:

JSON 
{
  "success": false,
  "error": {
    "code": "MISSING_REQUIRED_FIELDS",
    "message": "Body field \"name\" is required to create diskFolder."
  }
}

Ошибки

HTTP Код Описание
400 MISSING_REQUIRED_FIELDS Не передано поле name
400 MISSING_PARENT_ID Не передано поле parentId
400 READONLY_FIELD В теле передано поле только для чтения, например code
403 SCOPE_DENIED API-ключ не имеет скоупа disk
401 TOKEN_MISSING API-ключ не имеет настроенных токенов портала

Полный список общих ошибок API — Ошибки.

Смотрите также