---
id: collections-create-collection
title: "POST /api/collections — Создать коллекцию"
domain: collections
kind: api-method
http: "POST /api/collections"
---

# POST /api/collections — Создать коллекцию {#collections-create-collection}

## Сводка

| Поле | Значение |
|---|---|
| **HTTP** | `POST /api/collections` |
| **Auth** | `—` |
| **Scope токена** | `read_write` |
| **PG-функции** | `api.copy_default_collection_prompts`, `api.create_collection`, `api.get_user_active_org` |
| **Таблицы** | — |
| **SRM** | — (вне SRM, документировано по коду) |
| **RP (права)** | — |
| **Файл роута** | `server/routes/collections.js` |
| **Статус** | по коду (вне SRM) |

**Аргументы запроса** (best-effort из хендлера; путь-параметры опущены):

| Аргумент | Где | Обяз. | Заметка |
|---|---|---|---|
| `code` | body | | _подтвердить_ |
| `description` | body | | _подтвердить_ |
| `doc_title` | body | | _подтвердить_ |
| `is_public` | body | | _подтвердить_ |
| `name` | body | | _подтвердить_ |
| `tags` | body | | _подтвердить_ |

**Коды ответов/ошибок** (из хендлера): `201`, `400` (+ `200`) — _уточнить причины вручную_

Запись — нужен токен со scope `read_write` (см. [Конвенции](../../../shared/conventions.md#conventions)). У роута нет route-middleware с ролью — права проверяются внутри: создавать коллекции может org-admin (владельцем станет его активная организация) или site-admin. Под токеном сотрудника без админских прав вернётся `403`.

**Тело запроса (JSON):**

| Поле | Тип | Обяз. | Назначение |
|---|---|---|---|
| `code` | string | да | Короткий системный код коллекции |
| `name` | string | да | Отображаемое название |
| `description` | string | нет | Описание домена (по умолчанию пустое) |
| `doc_title` | string | нет | Заголовок проектного документа (по умолчанию `Design Document`) |
| `is_public` | boolean | нет | Публичность; по умолчанию `true` |
| `tags` | string[] | нет | Теги (нормализуются: ≤ 20 шт., ≤ 30 символов каждый) |

**Пример запроса:**

```bash
curl -X POST https://specbuilder.vnimanie.ai/api/collections \
  -H "Authorization: Bearer tak_..." \
  -H "Content-Type: application/json" \
  -d '{"code":"agro-ml","name":"Точное земледелие","is_public":false,"tags":["agro","ml"]}'
```

**Ответ `201`:**

```json
{ "id": "0660b640-86b0-42c5-8e22-93973848bb56" }
```

Владелец проставляется сервером: `created_by` — владелец токена, `owner_org_id` — его активная организация (не передаётся в теле). Cookie-клиент всегда получает JSON; Markdown-зеркало — токену с `Accept: text/markdown` (`server/agent/negotiate.js`).

Дальше коллекцию наполняют: [PUT /api/collections/{id}](update-collection.md#collections-update-collection) для полей, вложенные роуты для слоёв/блоков/ролей, и [GET /api/collections/{id}](get-collection.md#collections-get-collection) для просмотра результата.

<!-- gen:start:related -->
## Связанные
- [Конвенции](../../../shared/conventions.md#conventions) · [Роли](../../../shared/roles.md#roles) · [Ошибки](../../../shared/errors.md#errors) · [Глоссарий](../../../shared/glossary.md#glossary)
<!-- gen:end:related -->

---

Human view: https://docs.vnimanie.ai/specbuilder/v1/domains/collections/api/create-collection/