# POST /api/v1/auth/logout

Отозвать предъявленную web-сессию или TMA token и остановить связанные активные операции.

| Поле | Значение |
| --- | --- |
| URL | `POST https://aos.edgelab.space/api/v1/auth/logout` |
| Доступ | Cookie кабинета · Mini App (TMA) |
| Scope для ключей | ключи не принимаются – только кабинет (403 `CREDENTIAL_NOT_ALLOWED`) |
| operationId | `authLogout` |

## Описание

Отозвать предъявленную web-сессию или TMA token и остановить связанные активные операции. Участие в потоке для logout заново не проверяется.

**Auth:** сессия кабинета (cookie) / TMA bearer. **Scope:** не требуется.

**Path:** параметров нет.

**Query:** нет объявленных полей.

**Body:** не требуется.

**Ответ · статус и структура**

**Ответ:** 204, без тела.

Устанавливает или очищает cookie входа; login создаёт `__Host-aos_sess` на 30 дней (фактический срок сессии дополнительно проверяет БД).

**Ошибки:** `401 UNAUTHENTICATED`, `403 ORIGIN_REJECTED`, `403 CREDENTIAL_NOT_ALLOWED`; [общие ошибки](/docs/errors).

**Лимиты:** Отдельного throttle в коде нет.

```bash
curl -sS -i -X POST https://aos.edgelab.space/api/v1/auth/logout \
  --cookie '__Host-aos_sess=SESSION_PLACEHOLDER' \
  -H 'Origin: https://aos.edgelab.space'
```

## Ответы по контракту

| Статус | Тип | Схема | Описание |
| --- | --- | --- | --- |
| 204 | – | – | OK (sets or clears a cookie) |
| ошибка | application/json | [ErrorBody](/docs/schemas#errorbody) | Ошибка; коды: UNAUTHENTICATED, ORIGIN_REJECTED, CREDENTIAL_NOT_ALLOWED |

Машиночитаемый контракт: [openapi.json](/docs/openapi.json), операция `authLogout`.
