DELETE /api/projects/:id/permanent — Удалить безвозвратно
Сгенерировано из матриц + кода. Правки вносить в источники (
docs/matrices/,server/routes/), не здесь.
| Поле | Значение |
|---|---|
| HTTP | DELETE /api/projects/:id/permanent |
| Auth | requireAuth — только авторизованный |
| Scope токена | read_write |
| PG-функции | api.permanent_delete_project |
| Таблицы | project, project_node, project_edge, content_item |
| SRM | SRM-037 |
| RP (права) | RP-021 |
| Файл роута | server/routes/projects.js |
| Статус | done |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
аргументов не обнаружено (подтвердить вручную по server/routes/projects.js)
Коды ответов/ошибок (из хендлера): 403 (+ 200) — уточнить причины вручную
Для человека
Как открыть: на стартовом экране откройте вкладку «Корзина», найдите проект и нажмите «Удалить безвозвратно».
Удаляет проект без возможности восстановления — вместе со всем графом: нодами, связями и описаниями. После этого вернуть его уже нельзя, в отличие от обычного удаления в корзину. Применяйте, когда точно уверены, что проект больше не нужен.
Кто может. Безвозвратно удалить проект могут его владелец и администратор. Наблюдателю корзина недоступна.
Если прав нет — ошибка доступа (403).
Для агента
Запись — нужен токен со scope read_write (см. Конвенции). Эндпоинт под requireAuth: нужен авторизованный владелец токена, гостю недоступно. Вызов идёт под его ролью.
Тела у запроса нет — только идентификатор проекта в пути.
Операция необратима. Проект и все связанные строки (project_node, project_edge, content_item) удаляются физически — восстановления нет. Для обратимого удаления используйте удаление в корзину; вернуть из корзины можно через восстановление. Безвозвратное удаление применяйте только к проектам, уже лежащим в корзине.
Пример запроса:
curl -X DELETE https://specbuilder.vnimanie.ai/api/projects/a1b2c3d4-.../permanent \ -H "Authorization: Bearer tak_..."Ответ 200:
{ "ok": true }Cookie-клиент (браузер) всегда получает JSON; Markdown-зеркало отдаётся только токену с Accept: text/markdown (server/agent/negotiate.js).
Коды ошибок: 403 — нет прав на безвозвратное удаление этого проекта. Подробнее — Ошибки.