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

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

`POST /api/v1/files/folders`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/files/folders`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Имя, занятое соседом, не отвергается, а дополняется номером — как это делает проводник. Закрытым бывает только диск — is_restricted=true у папки внутри диска отклоняется (422, code=files.subfolder_restricted), папка не создаётся.

## Headers

- `X-Tenant` string, required

## Request body

- FilesFolderInput
  - `parent_id` string, uuid
  - `name` string, required
  - `icon` string
  - `color` string
  - `description` string
  - `kind` 'shared'
  - `is_restricted` boolean
  - `business_id` string, uuid

## Response `201`

Созданная папка

- FilesFolder
  - `id` string, uuid, required
  - `parent_id` string, uuid
  - `root_id` string, uuid, required
  - `depth` integer, required
  - `name` string, required
  - `kind` 'shared' | 'personal', required: Личное хранилище принадлежит своему владельцу целиком
  - `icon` string, required
  - `color` string, required
  - `description` string, required
  - `is_restricted` boolean, required: Закрытое хранилище видно только участникам его списка
  - `break_inheritance` boolean, required: Права хранилища на эту папку не действуют
  - `business_id` string, uuid, required
  - `owner_id` integer, required
  - `created_by` integer, required
  - `trashed_at` string, date-time
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `can_read` boolean, required
  - `can_write` boolean, required
  - `can_share` boolean, required: Право выпускать внешние ссылки; из открытости хранилища не следует
  - `can_manage` boolean, required
  - `is_favorite` boolean, required
  - `folder_count` integer, required
  - `file_count` integer, required
  - `size_bytes` integer, required

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `422`: Запрос разобран, но бизнес-значение недопустимо

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)