Список папок

Всё дерево папок одним запросом: в data – корневые папки, подпапки лежат внутри своего родителя.

Состав у каждой папки свой: объекты подпапки не входят в состав родителя, хотя в выдачу по его folder_id попадают.

Ответ

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

Корневые папки, по названию по алфавиту. Пагинации нет.

data[].idчисло

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

data[].user_idчисло

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

data[].nameстрока

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

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

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

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

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

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

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

data[].groups[].idчисло

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

data[].groups[].nameстрока

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

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

Подпапки этой папки, по названию по алфавиту.

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

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

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

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

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

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

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

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

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

Папка-родитель.

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

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

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

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

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

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

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

Всегда пусто: глубина ограничена двумя уровнями.

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

Идентификатор папки. Обычное целое число — папки не участвуют в кодировании идентификаторов.

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

Идентификатор владельца папки. Он же её создатель: папка всегда создаётся себе — POST /v2/folders не принимает чужого владельца.

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

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

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

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

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

Идентификатор родительской папки. null — папка корневая. Глубина ограничена двумя уровнями: папка → подпапка → группы, поэтому у подпапки подпапок быть не может.

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

Группы, лежащие непосредственно в этой папке (без групп подпапок). Приходят объектами с названиями, чтобы не ходить за ними в GET /v2/groups; на вход POST/PATCH принимают массив идентификаторов group_ids. Здесь виден состав, а не то, что попадёт в выдачу: выключенная (is_active=false) группа остаётся в составе, но отзывов и аналитики по folder_id не даёт — то же правило, что и в списке групп. Удалённая группа из состава пропадает.

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

Подпапки этой папки — каждая со своим составом. Порядок тот же, что у папок верхнего уровня: по названию, при совпадении — по id. Глубина ограничена двумя уровнями, поэтому у подпапки здесь всегда пустой список. У подпапки есть и свои группы, и они не смешиваются с группами родителя: groups каждой папки — только её собственный состав. В выдачу по folder_id (отзывы, аналитика) попадают группы папки и её подпапок.

curl -X GET "https://example.com/v2/folders"

{  "data": [    {      "id": 12,      "user_id": 6,      "name": "Москва",      "created_at": "2026-07-28T16:50:24",      "parent_folder_id": null,      "groups": [        {          "id": 20,          "name": "Националь"        },        {          "id": 21,          "name": "Метрополь"        }      ],      "subfolders": [        {          "id": 13,          "user_id": 6,          "name": "Центр",          "created_at": "2026-07-28T16:52:11",          "parent_folder_id": 12,          "groups": [            {              "id": 22,              "name": "Балчуг"            }          ],          "subfolders": []        }      ]    }  ]}

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