---
id: spaces-delete-space
title: "DELETE /api/spaces/:spaceId — Удалить спейс (в корзину)"
domain: spaces
kind: api-method
http: "DELETE /api/spaces/:spaceId"
---

# DELETE /api/spaces/:spaceId — Удалить спейс (в корзину) {#spaces-delete-space}

## Сводка

| Поле | Значение |
|---|---|
| **HTTP** | `DELETE /api/spaces/:spaceId` |
| **Auth** | `requireSpaceOrgAdmin` — requireSpaceOrgAdmin |
| **Scope токена** | `read_write` |
| **PG-функции** | `api.delete_space` |
| **Таблицы** | `space` |
| **SRM** | SRM-048, SRM-241 |
| **RP (права)** | RP-051 |
| **Файл роута** | `server/routes/spaces.js` |
| **Статус** | done |

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

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

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

Запись — токен со scope `read_write`. В `WRITE_ALLOW` как `SPACE_SOFT_DELETE`; маршрут защищён `requireSpaceOrgAdmin`, поэтому удалить спейс может только токен владельца-org_admin его организации (или site-admin, но site-admin-токенов не бывает) — иначе `403`.

**Путь:**

| Параметр | Где | Назначение |
|---|---|---|
| `id` | path | UUID спейса |

Тела у запроса нет.

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

```bash
curl -X DELETE https://specbuilder.vnimanie.ai/api/spaces/c0ffee00-1234-4abc-9def-0123456789ab \
  -H "Authorization: Bearer tak_..."
```

**Ответ `200`:**

```json
{ "ok": true }
```

**Если в спейсе есть проекты** — `400` с доменным кодом в теле (PG бросает `SPACE_HAS_PROJECTS`, который хендлер мапит на `400`):

```json
{ "error": "SPACE_HAS_PROJECTS: cannot delete space with 7 active project(s)" }
```

Удаление **идемпотентно**: повторный вызов на уже удалённый спейс вернёт `{ "ok": true }` без изменений. Достать спейс обратно — [восстановить спейс](restore-space.md#spaces-restore-space).

<!-- gen:start:related -->
## Связанные
- Экраны: [Настройки](../screens/settings.md#spaces-screen-settings) · [Спейсы](../screens/spaces-overview.md#spaces-screen-spaces-overview)
- [Конвенции](../../../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/spaces/api/delete-space/