---
id: org-remove-member
title: "DELETE /api/orgs/:orgId/members/:userId — Удалить участника"
domain: org
kind: api-method
http: "DELETE /api/orgs/:orgId/members/:userId"
---

# DELETE /api/orgs/:orgId/members/:userId — Удалить участника {#org-remove-member}

## Сводка

| Поле | Значение |
|---|---|
| **HTTP** | `DELETE /api/orgs/:orgId/members/:userId` |
| **Auth** | `—` |
| **Scope токена** | `read_write` |
| **PG-функции** | `api.remove_org_member` |
| **Таблицы** | `org_member` |
| **SRM** | SRM-127 |
| **RP (права)** | — |
| **Файл роута** | `server/routes/orgs.js` |
| **Статус** | done |

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

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

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

Запись — нужен токен со scope `read_write` (см. [Конвенции](../../../shared/conventions.md#conventions)). Эта операция **разрешена токену** (agent-gate, `ORG_MEMBER_REMOVE`), но дальше PG-функция проверяет, что вызывающий — администратор организации: токен под ролью обычного участника получит `403`.

Путь-параметры: `:orgId` — UUID организации, `:userId` — UUID исключаемого участника. Тела запроса нет.

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

```bash
curl -X DELETE https://specbuilder.vnimanie.ai/api/orgs/0c8f1e2a-.../members/3f2c... \
  -H "Authorization: Bearer tak_..."
```

**Ответ `200`** — пустой объект (функция ничего не возвращает):

```json
{}
```

**Отказы** (тело `{ "error": "<КОД>" }`):
- `403` — вызывающий не администратор организации (`ACCESS_DENIED`);
- `400` — `CANNOT_REMOVE_SELF` (себя удалять нельзя) или `HAS_OWNED_PROJECTS` (у участника есть активные проекты — сначала передайте владение через [сменить владельца](../../projects/api/transfer-owner.md#projects-transfer-owner)).

Markdown-зеркала у мутации нет — ответ всегда JSON.

<!-- gen:start:related -->
## Связанные
- Экраны: [Организация](../screens/organization.md#org-screen-organization)
- [Конвенции](../../../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/org/api/remove-member/