POST /api/projects — Создать проект
Как открыть: на стартовом экране со списком проектов нажмите «+ Новый проект» в шапке. Откроется экран создания: выберите «Компания × Спейс × Коллекция» и опишите задачу.
Создаёт новый проект из текстового описания задачи. Поле задачи обязательно, до 5000 символов; пустое или длиннее — ошибка 400.
Название можно не вводить. Если оставить его пустым, короткое имя из 3–5 слов придумает LLM: оно генерируется до создания проекта (поэтому запрос занимает на пару секунд дольше), и проект сразу появляется в списке с готовым названием.
Проект всегда создаётся внутри спейса:
- Гость (без входа) — проект попадает в гостевой спейс выбранной коллекции. Коллекция должна быть публичной или дефолтной, иначе гость её не видит (
403). - Авторизованный — проект попадает в личный спейс выбранной коллекции; если такого спейса ещё нет, он создаётся автоматически — при этом проверяется ваш доступ к коллекции.
Вместо коллекции можно сразу выбрать конкретный спейс, например командный в организации. Сразу после создания обычно запускают генерацию графа.
Кто может. Создать проект может любой, у кого есть доступ к коллекции: гость — к публичной или дефолтной; сотрудник и выше — к коллекциям своей организации и к тем, доступ к которым выдан отдельно. Наблюдатель кнопки создания не видит. Точные правила — RP-155.
Связанные
- Экраны: Создание проекта
- Конвенции · Роли · Ошибки · Глоссарий
Машинная сводка (HTTP, таблицы, связанные требования)
| Поле | Значение |
|---|---|
| HTTP | POST /api/projects |
| Auth | optionalAuth — гость + авторизованный |
| Scope токена | read_write |
| PG-функции | api.create_project |
| Таблицы | project |
| SRM | SRM-010, SRM-219 |
| RP (права) | RP-001, RP-002, RP-014 |
| Файл роута | server/routes/projects.js |
| Статус | done |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
| Аргумент | Где | Обяз. | Заметка |
|---|---|---|---|
collection_id | body | подтвердить | |
prompt | body | подтвердить | |
space_id | body | подтвердить | |
title | body | подтвердить |
Коды ответов/ошибок (из хендлера): 201, 400, 403, 404 (+ 200) — уточнить причины вручную