06.03.2026 00:00

Add

[POST] …/v1/folder/add

Создаёт новую папку.

Метод доступен при версии БД >= 365.

Входные параметры

Название Тип данных Обязательность Описание
name String Обязательный Наименование папки
parent_id Int64 Необязательный Родительская папка. По умолчанию используется root (id = 1)
access_level FileAccessLevelEnum Необязательный personal или public

Бизнес-правила

  • Запрещены дубли имён внутри одного parent_id для одного владельца.
  • Проверяется существование и доступность parent_id.
  • Максимальная глубина вложенности: 5.

Пример запроса

{
  "name": "Acts",
  "parent_id": 10,
  "access_level": "personal"
}

Выходные параметры

Название Тип данных Описание
new_id long ID созданной папки

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

{
  "ok": true,
  "result": {
    "new_id": 25
  }
}