---
id: org-delete-invite
title: "DELETE /api/orgs/:orgId/invites/:id — Отозвать приглашение"
domain: org
kind: api-method
http: "DELETE /api/orgs/:orgId/invites/:id"
---

# DELETE /api/orgs/:orgId/invites/:id — Отозвать приглашение {#org-delete-invite}

## Сводка

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

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

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

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

Запись — токен со scope `read_write`. Операция **разрешена токену** (agent-gate, `ORG_INVITE_REVOKE`); PG-функция требует, чтобы вызывающий был администратором организации — иначе `403`. В отличие от чтения списка приглашений (оно для токенов закрыто, т.к. содержит секреты), отзыв конкретного приглашения по его id токену доступен.

Путь-параметры: `:orgId` — UUID организации, `:id` — UUID приглашения. Тела запроса нет.

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

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

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

```json
{}
```

Под капотом приглашение помечается истёкшим (`status = 'expired'`), а не удаляется из таблицы. Если вызывающий не администратор организации — `403` (`ACCESS_DENIED`). 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/delete-invite/