Изменить папку
Переименовывает, переносит и меняет состав папки за один вызов. Меняется только то, что передано.
object_ids заменяет состав целиком, а не дополняет его. Чтобы добавить один объект, передайте
её вместе с теми, что уже лежат в папке.
Объект, который положить не удалось, остальной состав не отменяет: он не попадёт в папку, а его
идентификатор вернётся в ignored_object_ids.
Параметры
folder_idчислообязательныйПапка, которую нужно изменить.
Тело запроса
nameстрокаНовое название, 1–255 символов. Не передано – остаётся прежним.
parent_folder_idчислоПеренести папку внутрь другой. null – вынести в корень. Не передано – остаётся где была.
object_idsсписок чиселНовый состав папки целиком. Пустой список очищает состав.
Ответ
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дата и времяКогда подпапка создана.
subfolders[].parent_folder_idчисломожет быть пустымПапка-родитель.
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 PATCH "https://example.com/v3/folders/0" \ -H "Content-Type: application/json" \ -d '{ "name": "Москва и область", "object_ids": [ 20, 21, 22, 99 ] }'{ "id": 12, "user_id": 6, "name": "Москва и область", "created_at": "2026-07-28T16:50:24", "parent_folder_id": null, "objects": [ { "id": 20, "name": "Националь" }, { "id": 21, "name": "Метрополь" }, { "id": 22, "name": "Балчуг" } ], "subfolders": [ { "id": 13, "user_id": 6, "name": "Центр", "created_at": "2026-07-28T16:52:11", "parent_folder_id": 12, "objects": [ { "id": 22, "name": "Балчуг" } ], "subfolders": [] } ], "ignored_object_ids": [ 99 ]}Коды ошибок общие для всего API и описаны на странице Ошибки.