GET /api/spaces/deleted — Удалённые спейсы

Сгенерировано из матриц + кода. Правки вносить в источники (docs/matrices/, server/routes/), не здесь.

Поле	Значение
HTTP	`GET /api/spaces/deleted`
Auth	`—`
Scope токена	`read`
PG-функции	`api.list_deleted_spaces`
Таблицы	—
SRM	— (вне SRM, документировано по коду)
RP (права)	—
Файл роута	`server/routes/spaces.js`
Статус	по коду (вне SRM)

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

аргументов не обнаружено (подтвердить вручную по server/routes/spaces.js)

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

Для человека

Как открыть: раздел «Корзина» в управлении организацией — там лежат мягко удалённые командные спейсы. Удаление спейса обратимо: он отправляется в корзину, а не исчезает.

Возвращает список спейсов, лежащих в корзине: имя, slug, организация, коллекция и время удаления. Из этого списка спейс можно восстановить.

Удаление спейса — это мягкое удаление: запись остаётся в базе с пометкой времени, поэтому её видно здесь и можно вернуть. Автоочистки корзины нет.

Кто может. Корзину спейсов видит администратор организации (свои удалённые спейсы) и администратор платформы (все). Сотрудник, спейсмен и наблюдатель сюда не ходят (RP-139). Без авторизации — 401.

Для агента

Чтение — токен со scope read. Путь на read-allowlist’е, токен сюда проходит (server/auth/agentGate.js). Выдача считается от лица владельца: org_admin видит удалённые спейсы своих организаций; обычный сотрудник получит пустой список.

⚠️ Маршрут объявлен до динамического /api/spaces/:id, поэтому deleted — это литеральный сегмент, а не id спейса. Запрос не нужно ничем дополнять.

Параметров и тела у запроса нет.

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

curl https://specbuilder.vnimanie.ai/api/spaces/deleted \
  -H "Authorization: Bearer tak_..."

Ответ 200:

[
  {
    "id": "c0ffee00-1234-4abc-9def-0123456789ab",
    "type": "team",
    "name": "Старый отдел",
    "slug": "legacy",
    "org_id": "0011aabb-...",
    "org_name": "ООО «Будущее»",
    "collection_id": "0660b640-86b0-42c5-8e22-93973848bb56",
    "collection_name": "ML/AI Development",
    "deleted_at": "2026-06-10T09:14:00.000Z"
  }
]

Только JSON — Markdown-зеркала у этого листинга нет. Следующий шаг — восстановить спейс (нужен scope read_write и роль org_admin).

Связанные

Конвенции · Роли · Ошибки · Глоссарий