POST /api/site-admin/logout — Выход site-admin

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

Поле	Значение
HTTP	POST /api/site-admin/logout
Auth	—
Scope токена	read_write
PG-функции	api.admin_logout
Таблицы	admin_session
SRM	SRM-131
RP (права)	—
Файл роута	server/routes/site-admin.js
Статус	done

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

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

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

Для человека

Как открыть: в Admin Panel нажмите «Выйти» — обычно в шапке панели администратора. После этого вы возвращаетесь на страницу входа site-admin.

Закрывает сессию администратора платформы: сервер удаляет её, а из браузера убирается сессионная cookie. После выхода в панель уже не зайти без нового входа — пароль и при необходимости код TOTP. Полезно на чужом или общем компьютере: завершайте сессию явно, не полагаясь на то, что она истечёт сама.

Выход всегда отрабатывает «успешно», даже если сессия уже была просрочена, — повторное нажатие или выход из неактуальной сессии не дают ошибки.

Кто может. Администратор платформы — для своей сессии.

Для агента

Это операция site-admin, и она недоступна API-токену ни на каком scope. Выход завершает человеческую cookie-сессию администратора (admin_sid); токену завершать нечего.

Путь /api/site-admin/* закрыт для Bearer-токенов в agent-gate (server/auth/agentGate.js) — не в allowlist (закрыто по умолчанию), поэтому POST с Authorization: Bearer tak_... возвращает 403 (Forbidden for token). Markdown-зеркала нет.

Вызывается браузером с cookie-сессией; тела запроса нет:

curl -X POST https://specbuilder.vnimanie.ai/api/site-admin/logout -b admin-cookies.txt

Ответ 200:

{ "ok": true }

Эндпоинт всегда отвечает { "ok": true }: cookie сбрасывается всегда, а удаление серверной сессии — best-effort (ошибки на выходе глушатся), поэтому выход из уже истёкшей сессии не падает.

Связанные

• Экраны: Admin Panel
• Конвенции · Роли · Ошибки · Глоссарий