---
title: "Создать папку"
method: POST
path: "/v3/folders"
tags: ["folders"]
---

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

`POST /v3/folders`

## Request

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

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

`object_ids` — это полный состав, а не добавление: список заменяет прежний
целиком. Недоступные идентификаторы не валят запрос, а возвращаются в
`ignored_object_ids`.

## Headers

- `Idempotency-Key` string, nullable

## Request body

- FolderCreateV3: Тело создания папки.
  - `name` string, required: Название папки.
  - `parent_folder_id` integer, nullable: Родительская папка. Глубина ограничена двумя ступенями.
  - `object_ids` integer[], nullable: Состав папки. Присылается целиком: список полностью заменяет прежний. Недоступные идентификаторы возвращаются в `ignored_object_ids`.

## Response `201`

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)