# Создать папку архива — умную (по правилу) или подборку

export default function Layout(props) {
  const { OpenAPIPage } = props.components ?? {};
  return (
    <>
      {props.children}
      ## Создать папку архива — умную (по правилу) или подборку

`POST /api/v1/files/shelf/folders`

**Авторизация:** dpop или oauth2: `files:write`

**Тело запроса** (`application/json`, обязательное): ShelfCreateFolderRequest
- `kind`: "smart" | "manual", обязательное — smart — наполняется по правилу, manual — подборка вручную
- `layout`: "none" | "year" | "quarter" | "month" | "party" | "kind" | "document" — Раскладка папки: подпапки по годам, кварталам, месяцам и т. д.
- `name`: string, обязательное — Название папки
- `rule`: any — Правило умной папки в формате @legalstack/logic: { match, conditions }

**Ответы**

- `200` — Папка создана (`application/json`, ShelfFolder)
  - `createdAt`: string, обязательное — Когда создана, ISO 8601
  - `createdBy`: string, обязательное — Автор папки
  - `id`: string, обязательное — Идентификатор папки
  - `kind`: "smart" | "manual", обязательное — Вид папки
  - `layout`: "none" | "year" | "quarter" | "month" | "party" | "kind" | "document", обязательное — Раскладка папки: подпапки по годам, кварталам, месяцам и т. д.
  - `name`: string, обязательное — Название
  - `rule`: any — Правило умной папки
  - `updatedAt`: string, обязательное — Когда изменена, ISO 8601
- `400` — Некорректный запрос: не прошла валидация параметров или тела (`application/problem+json`, ProblemDetails)
- `401` — Токен отсутствует, недействителен или истёк (`application/problem+json`, ProblemDetails)
- `403` — Недостаточно прав или scope (`application/problem+json`, ProblemDetails)

    </>
  );
}