Перейти к содержимому

DELETE /api/spaces/:id/members/:userId — Удалить участника

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

ПолеЗначение
HTTPDELETE /api/spaces/:id/members/:userId
AuthrequireSpacemanOrOrgAdmin — requireSpacemanOrOrgAdmin
Scope токенаread_write
PG-функцииapi.remove_space_member
Таблицы
SRM— (вне SRM, документировано по коду)
RP (права)
Файл роутаserver/routes/spaces.js
Статуспо коду (вне SRM)

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

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

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

Для человека

Как открыть: вкладка «Спейсы» → карточка спейса → «Настройки спейса»«Участники» → у нужного человека действие исключения (под «…» / иконкой).

Исключает участника из спейса. Человек теряет доступ к спейсу и его проектам, но остаётся сотрудником организации — это удаление только из состава спейса, не из компании. Исключить участника, у которого в этом спейсе есть активные проекты, нельзя — сначала нужно разобраться с проектами (иначе придёт ошибка HAS_PROJECTS).

Кто может. Менеджер спейса (спейсмен) или администратор организации (requireSpacemanOrOrgAdmin). Остальные — 403.

Для агента

Запись — токен со scope read_write. Путь DELETE /api/spaces/:id/members/:userId на write-allowlist’е (server/auth/agentGate.js, операция SPACE_MEMBER_REMOVE). Под ролью владельца токена: спейсмен спейса или org_admin, иначе 403.

Путь:

ПараметрГдеНазначение
idpathUUID спейса
userIdpathUUID исключаемого участника

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

Окно терминала
curl -X DELETE https://specbuilder.vnimanie.ai/api/spaces/a1b2c3d4-5678-49ab-8cde-f0123456789a/members/8a4b2c33-1d55-4e66-9f77-bb22cc33dd44 \
-H "Authorization: Bearer tak_..."

Ответ 200:

{ "ok": true }

Ответ 400 (у участника есть активные проекты в спейсе) — доменный код HAS_PROJECTS:

{ "error": "HAS_PROJECTS" }

Только JSON. После исключения участник пропадёт из списка участников.

Связанные