---
title: "Изменить папку"
method: PATCH
path: "/v3/folders/{folder_id}"
tags: ["folders"]
---

# Изменить папку

`PATCH /v3/folders/{folder_id}`

## Request

- Base URL: `https://api.rewio.ru`
- URL: `https://api.rewio.ru/v3/folders/{folder_id}`
- Auth: API key in header `X-API-Key`

Изменить название, родителя или состав папки.

Переданный `object_ids` заменяет состав целиком; не переданный — оставляет
как был.

## Path parameters

- `folder_id` integer, required: Идентификатор папки.

## Request body

- FolderUpdateV3: Тело изменения папки — передавайте только изменяемые поля.
  - `name` string, nullable: Новое название папки.
  - `parent_folder_id` integer, nullable: Новый родитель папки.
  - `object_ids` integer[], nullable: Новый состав папки — полная замена прежнего. Недоступные идентификаторы возвращаются в `ignored_object_ids`.

## Response `200`

Successful Response

- FolderWriteV3: Ответ на создание и изменение — та же папка плюс список пропущенного.
  - `id` integer, required: Идентификатор папки.
  - `user_id` integer, required: Номер клиента – владельца папки.
  - `name` string, required: Название папки.
  - `created_at` string, date-time, required: Момент создания папки (UTC, ISO 8601).
  - `parent_folder_id` integer, nullable: Родительская папка; `null` у папки верхнего уровня.
  - `objects` FolderObjectV3[]: Собственный состав папки — объекты с названиями.
    - `id` integer, required: Идентификатор объекта.
    - `name` string, required: Название объекта.
  - `subfolders` FolderV3[]: Подпапки со своим составом.
    - `id` integer, required: Идентификатор папки.
    - `user_id` integer, required: Номер клиента – владельца папки.
    - `name` string, required: Название папки.
    - `created_at` string, date-time, required: Момент создания папки (UTC, ISO 8601).
    - `parent_folder_id` integer, nullable: Родительская папка; `null` у папки верхнего уровня.
    - `objects` FolderObjectV3[]: Собственный состав папки — объекты с названиями.
      - `id` integer, required: Идентификатор объекта.
      - `name` string, required: Название объекта.
    - `subfolders` FolderV3[]: Подпапки со своим составом.
    - `review_count` integer, nullable: Сколько отзывов в ленте папки (`GET /v3/reviews?folder_id=`): объекты папки и её подпапок, отзыв общей для двух объектов ссылки считается один раз.
    - `is_demo` boolean: Папка примеров, которую кабинет кладёт новому клиенту.
  - `review_count` integer, nullable: Сколько отзывов в ленте папки (`GET /v3/reviews?folder_id=`): объекты папки и её подпапок, отзыв общей для двух объектов ссылки считается один раз.
  - `is_demo` boolean: Папка примеров, которую кабинет кладёт новому клиенту.
  - `ignored_object_ids` integer[]: Идентификаторы из присланного `object_ids`, которые в состав не попали: чужие, удалённые или несуществующие объекты. Запрос при этом выполняется — остальные объекты кладутся в папку.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/rewio/apis/review-aggregator.md) · [All operations](https://skmtc.dev/rewio/apis/review-aggregator/llms.txt) · [OpenAPI document](https://skmtc.dev/rewio/apis/review-aggregator/revisions/9222b6cf28a5?raw)