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

Папка объединяет объекты, чтобы спрашивать отзывы и аналитику сразу по всем: GET /v3/reviews?folder_id=… отдаёт единую ленту по всем объектам папки и её подпапок.

Глубина – два уровня: папка → подпапка → объекты. Один объект может лежать сразу в нескольких папках.

Объект, который положить не удалось, создать папку не мешает: он не попадёт в состав, а его идентификатор вернётся в ignored_object_ids.

Параметры

Idempotency-Keyстрока

Свой ключ запроса. Повтор с тем же ключом не создаст вторую папку.

Тело запроса

nameстрокаобязательный

Название папки, 1–255 символов.

parent_folder_idчисло

Положить папку внутрь другой. Не передано – папка окажется в корне.

object_idsсписок чисел

Объекты, которые сразу положить в папку, до 200.

Ответ

idчисло

Идентификатор созданной папки.

user_idчисло

Владелец папки.

nameстрока

Название папки.

created_atдата и время

Когда папка создана.

parent_folder_idчисломожет быть пустым

Папка-родитель. Пусто – папка лежит в корне.

objectsсписок объектов

Объекты, лежащие непосредственно в этой папке.

objects[].idчисло

Идентификатор объекта.

objects[].nameстрока

Название объекта.

subfoldersсписок объектов

Подпапки этой папки. У новой папки список пустой.

subfolders[].idчисло

Идентификатор папки.

subfolders[].user_idчисло

Владелец папки.

subfolders[].nameстрока

Название папки.

subfolders[].created_atдата и время

Момент создания папки (UTC, ISO 8601).

subfolders[].parent_folder_idчисломожет быть пустым

Родительская папка; null у папки верхнего уровня.

subfolders[].objectsсписок объектов

Собственный состав папки — объекты с названиями.

subfolders[].objects[].idчисло

Идентификатор объекта.

subfolders[].objects[].nameстрока

Название объекта.

subfolders[].subfoldersсписок объектов

Подпапки со своим составом.

subfolders[].subfolders[].idчисло

Идентификатор папки.

subfolders[].subfolders[].user_idчисло

Владелец папки.

subfolders[].subfolders[].nameстрока

Название папки.

subfolders[].subfolders[].created_atдата и время

Момент создания папки (UTC, ISO 8601).

subfolders[].subfolders[].parent_folder_idчисломожет быть пустым

Родительская папка; null у папки верхнего уровня.

subfolders[].subfolders[].objectsсписок объектов

Собственный состав папки — объекты с названиями.

subfolders[].subfolders[].objects[].idчисло

Идентификатор объекта.

subfolders[].subfolders[].objects[].nameстрока

Название объекта.

subfolders[].subfolders[].subfoldersсписок объектов

Подпапки со своим составом.

subfolders[].subfolders[].subfolders[].idчисло

Идентификатор папки.

subfolders[].subfolders[].subfolders[].user_idчисло

Владелец папки.

subfolders[].subfolders[].subfolders[].nameстрока

Название папки.

subfolders[].subfolders[].subfolders[].created_atдата и время

Момент создания папки (UTC, ISO 8601).

subfolders[].subfolders[].subfolders[].parent_folder_idчисломожет быть пустым

Родительская папка; null у папки верхнего уровня.

subfolders[].subfolders[].subfolders[].objectsсписок объектов

Собственный состав папки — объекты с названиями.

subfolders[].subfolders[].subfolders[].subfoldersсписок объектов

Подпапки со своим составом.

ignored_object_idsсписок чисел

Идентификаторы из object_ids, которые в состав не попали: чужие, удалённые или несуществующие.

curl -X POST "https://example.com/v3/folders" \  -H "Content-Type: application/json" \  -d '{    "name": "Москва",    "object_ids": [      20,      21    ]  }'

{  "id": 12,  "user_id": 6,  "name": "Москва",  "created_at": "2026-07-28T16:50:24",  "parent_folder_id": null,  "objects": [    {      "id": 20,      "name": "Националь"    },    {      "id": 21,      "name": "Метрополь"    }  ],  "subfolders": [],  "ignored_object_ids": []}

Коды ошибок общие для всего API и описаны на странице Ошибки.