# Безопасность и доступ

> REST API раздела «Безопасность и доступ»: 139 операций.

Базовый адрес: `https://api.legalstack.ru`. Спецификация: [openapi/security.json](https://docs.legalstack.ru/openapi/security.json).

- [Аутентификация](https://docs.legalstack.ru/api/security/auth): Регистрация, вход, восстановление пароля, верификация e-mail.
- [Пользователи](https://docs.legalstack.ru/api/security/users): Управление пользователями.
- [Устройства и сессии](https://docs.legalstack.ru/api/security/devices): Активные сессии и устройства пользователя.
- [Команды](https://docs.legalstack.ru/api/security/teams): Управление командами.
- [Группы](https://docs.legalstack.ru/api/security/groups): Группы пользователей.
- [Оргструктура](https://docs.legalstack.ru/api/security/org): Оргструктура: подразделения, руководители, место сотрудников и агентов.
- [Приглашения](https://docs.legalstack.ru/api/security/invites): Приглашения пользователей в команду.
- [OAuth 2.0](https://docs.legalstack.ru/api/security/oauth): OAuth 2.0: авторизация, выдача, отзыв и проверка токенов.
- [OAuth-приложения](https://docs.legalstack.ru/api/security/oauth-clients): Управление OAuth-приложениями.
- [Персональные токены](https://docs.legalstack.ru/api/security/personal-tokens): Персональные API-токены.
- [Каталог OAuth-scopes](https://docs.legalstack.ru/api/security/scopes): Каталог OAuth-scopes платформы.
- [Единый вход (SSO)](https://docs.legalstack.ru/api/security/sso): Единый вход (SSO): подключения SAML и OIDC для команды.
- [Вебхуки](https://docs.legalstack.ru/api/security/webhooks): Подписки на вебхуки и проверка подписей.
- [Ключи JWKS](https://docs.legalstack.ru/api/security/jwks): Публичные ключи (JWKS) для проверки подписи JWT.
- [Контроль доступа](https://docs.legalstack.ru/api/security/access): Контроль доступа: правила, проверки, матрицы.
- [Агенты](https://docs.legalstack.ru/api/security/agents): Агенты команды: настройки, история версий и откат.
- [Доступ к агентам](https://docs.legalstack.ru/api/security/agent-access): Доступ к агенту: кто пользуется, настраивает, создаёт расписания и работает с браузером.
- [Лимиты агентов](https://docs.legalstack.ru/api/security/agent-limits): Лимиты работы агентов: месячный расход команды и сотрудников, лимиты на сотрудника.
- [Аудит безопасности](https://docs.legalstack.ru/api/security/audit): Журнал аудита событий безопасности.
- [Защита от ботов](https://docs.legalstack.ru/api/security/anti-bot): Защита от ботов: задачи proof-of-work (ALTCHA).
- [Поддержка](https://docs.legalstack.ru/api/security/support): Обращения пользователей в поддержку.

## Операции

Всего операций: 139. У каждой операции своя страница со схемами запроса и ответа и примерами вызова.

### [Аутентификация](https://docs.legalstack.ru/api/security/auth)

| Метод | Путь | Операция |
| --- | --- | --- |
| `POST` | `/api/v1/security/auth/2fa/disable` | [Отключить 2FA](https://docs.legalstack.ru/api/security/auth/post-security-auth-2fa-disable) |
| `POST` | `/api/v1/security/auth/2fa/enable-confirm` | [Подтвердить настройку 2FA первым кодом](https://docs.legalstack.ru/api/security/auth/post-security-auth-2fa-enable-confirm) |
| `POST` | `/api/v1/security/auth/2fa/enable-init` | [Запустить настройку 2FA (TOTP)](https://docs.legalstack.ru/api/security/auth/post-security-auth-2fa-enable-init) |
| `POST` | `/api/v1/security/auth/2fa/regenerate-codes` | [Перевыпустить резервные коды](https://docs.legalstack.ru/api/security/auth/post-security-auth-2fa-regenerate-codes) |
| `PUT` | `/api/v1/security/auth/change-password` | [Смена пароля](https://docs.legalstack.ru/api/security/auth/put-security-auth-change-password) |
| `POST` | `/api/v1/security/auth/login` | [Вход](https://docs.legalstack.ru/api/security/auth/post-security-auth-login) |
| `POST` | `/api/v1/security/auth/logout` | [Выход](https://docs.legalstack.ru/api/security/auth/post-security-auth-logout) |
| `DELETE` | `/api/v1/security/auth/profile` | [Удалить текущий аккаунт](https://docs.legalstack.ru/api/security/auth/delete-security-auth-profile) |
| `GET` | `/api/v1/security/auth/profile` | [Профиль текущего пользователя](https://docs.legalstack.ru/api/security/auth/get-security-auth-profile) |
| `PUT` | `/api/v1/security/auth/profile` | [Обновить профиль](https://docs.legalstack.ru/api/security/auth/put-security-auth-profile) |
| `POST` | `/api/v1/security/auth/refresh` | [Обновить токен доступа](https://docs.legalstack.ru/api/security/auth/post-security-auth-refresh) |
| `POST` | `/api/v1/security/auth/register` | [Регистрация](https://docs.legalstack.ru/api/security/auth/post-security-auth-register) |
| `POST` | `/api/v1/security/auth/request-password-reset` | [Запрос сброса пароля](https://docs.legalstack.ru/api/security/auth/post-security-auth-request-password-reset) |
| `POST` | `/api/v1/security/auth/resend-verification` | [Повторно отправить письмо подтверждения](https://docs.legalstack.ru/api/security/auth/post-security-auth-resend-verification) |
| `POST` | `/api/v1/security/auth/reset-password` | [Сброс пароля](https://docs.legalstack.ru/api/security/auth/post-security-auth-reset-password) |
| `POST` | `/api/v1/security/auth/verify-email` | [Подтвердить e-mail](https://docs.legalstack.ru/api/security/auth/post-security-auth-verify-email) |
| `POST` | `/api/v1/security/auth/verify-totp` | [Подтверждение 2FA при входе](https://docs.legalstack.ru/api/security/auth/post-security-auth-verify-totp) |

### [Пользователи](https://docs.legalstack.ru/api/security/users)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/api/v1/security/users` | [Список пользователей команды](https://docs.legalstack.ru/api/security/users/get-security-users) |
| `POST` | `/api/v1/security/users/link-telegram` | [Привязать Telegram-аккаунт](https://docs.legalstack.ru/api/security/users/post-security-users-link-telegram) |
| `DELETE` | `/api/v1/security/users/me/away` | [Снять отметку об отсутствии](https://docs.legalstack.ru/api/security/users/delete-security-users-me-away) |
| `PUT` | `/api/v1/security/users/me/away` | [Отметить отсутствие текущего пользователя](https://docs.legalstack.ru/api/security/users/put-security-users-me-away) |
| `DELETE` | `/api/v1/security/users/me/favorites` | [Убрать из избранного](https://docs.legalstack.ru/api/security/users/delete-security-users-me-favorites) |
| `GET` | `/api/v1/security/users/me/favorites` | [Избранное текущего пользователя](https://docs.legalstack.ru/api/security/users/get-security-users-me-favorites) |
| `POST` | `/api/v1/security/users/me/favorites` | [Добавить в избранное](https://docs.legalstack.ru/api/security/users/post-security-users-me-favorites) |
| `PATCH` | `/api/v1/security/users/me/onboarding` | [Завершить онбординг текущего пользователя](https://docs.legalstack.ru/api/security/users/patch-security-users-me-onboarding) |
| `GET` | `/api/v1/security/users/search-by-email` | [Найти пользователя по e-mail](https://docs.legalstack.ru/api/security/users/get-security-users-search-by-email) |
| `GET` | `/api/v1/security/users/team` | [Список участников команды](https://docs.legalstack.ru/api/security/users/get-security-users-team) |
| `POST` | `/api/v1/security/users/telegram/generate-code` | [Сгенерировать код привязки Telegram](https://docs.legalstack.ru/api/security/users/post-security-users-telegram-generate-code) |
| `GET` | `/api/v1/security/users/telegram/status` | [Статус привязки Telegram для текущего пользователя](https://docs.legalstack.ru/api/security/users/get-security-users-telegram-status) |
| `DELETE` | `/api/v1/security/users/telegram/unlink` | [Отвязать Telegram текущего пользователя](https://docs.legalstack.ru/api/security/users/delete-security-users-telegram-unlink) |
| `POST` | `/api/v1/security/users/unlink-telegram` | [Отвязать Telegram-аккаунт](https://docs.legalstack.ru/api/security/users/post-security-users-unlink-telegram) |
| `GET` | `/api/v1/security/users/with-telegram` | [Список пользователей с привязанным Telegram](https://docs.legalstack.ru/api/security/users/get-security-users-with-telegram) |
| `DELETE` | `/api/v1/security/users/{id}` | [Удалить пользователя](https://docs.legalstack.ru/api/security/users/delete-security-users-id) |
| `PUT` | `/api/v1/security/users/{id}/groups` | [Обновить группы пользователя](https://docs.legalstack.ru/api/security/users/put-security-users-id-groups) |
| `GET` | `/api/v1/security/users/{id}/handover` | [Что перейдёт преемнику при удалении участника](https://docs.legalstack.ru/api/security/users/get-security-users-id-handover) |
| `PUT` | `/api/v1/security/users/{id}/role` | [Обновить роль пользователя](https://docs.legalstack.ru/api/security/users/put-security-users-id-role) |

### [Устройства и сессии](https://docs.legalstack.ru/api/security/devices)

| Метод | Путь | Операция |
| --- | --- | --- |
| `DELETE` | `/api/v1/security/me/devices` | [Отозвать все устройства, кроме текущего](https://docs.legalstack.ru/api/security/devices/delete-security-me-devices) |
| `GET` | `/api/v1/security/me/devices` | [Активные устройства текущего пользователя](https://docs.legalstack.ru/api/security/devices/get-security-me-devices) |
| `DELETE` | `/api/v1/security/me/devices/{deviceId}` | [Отозвать устройство](https://docs.legalstack.ru/api/security/devices/delete-security-me-devices-deviceid) |

### [Команды](https://docs.legalstack.ru/api/security/teams)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/api/v1/security/teams/current` | [Получить текущую команду](https://docs.legalstack.ru/api/security/teams/get-security-teams-current) |
| `PATCH` | `/api/v1/security/teams/current` | [Обновить текущую команду](https://docs.legalstack.ru/api/security/teams/patch-security-teams-current) |
| `DELETE` | `/api/v1/security/teams/current/ownership-transfer` | [Отменить передачу владения командой](https://docs.legalstack.ru/api/security/teams/delete-security-teams-current-ownership-transfer) |
| `POST` | `/api/v1/security/teams/current/ownership-transfer` | [Запросить передачу владения командой](https://docs.legalstack.ru/api/security/teams/post-security-teams-current-ownership-transfer) |
| `POST` | `/api/v1/security/teams/current/ownership-transfer/accept` | [Принять владение командой](https://docs.legalstack.ru/api/security/teams/post-security-teams-current-ownership-transfer-accept) |
| `POST` | `/api/v1/security/teams/current/ownership-transfer/decline` | [Отклонить передачу владения командой](https://docs.legalstack.ru/api/security/teams/post-security-teams-current-ownership-transfer-decline) |
| `PATCH` | `/api/v1/security/teams/current/slug` | [Сменить короткое имя команды (slug)](https://docs.legalstack.ru/api/security/teams/patch-security-teams-current-slug) |

### [Группы](https://docs.legalstack.ru/api/security/groups)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/api/v1/security/groups` | [Список групп](https://docs.legalstack.ru/api/security/groups/get-security-groups) |
| `POST` | `/api/v1/security/groups` | [Создать группу](https://docs.legalstack.ru/api/security/groups/post-security-groups) |
| `DELETE` | `/api/v1/security/groups/{id}` | [Удалить группу](https://docs.legalstack.ru/api/security/groups/delete-security-groups-id) |
| `GET` | `/api/v1/security/groups/{id}` | [Получить группу по id](https://docs.legalstack.ru/api/security/groups/get-security-groups-id) |
| `PATCH` | `/api/v1/security/groups/{id}` | [Обновить группу](https://docs.legalstack.ru/api/security/groups/patch-security-groups-id) |

### [Оргструктура](https://docs.legalstack.ru/api/security/org)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/api/v1/security/org` | [Оргструктура команды](https://docs.legalstack.ru/api/security/org/get-security-org) |
| `PUT` | `/api/v1/security/org/agents/{agentId}` | [Место агента в структуре](https://docs.legalstack.ru/api/security/org/put-security-org-agents-agentid) |
| `PUT` | `/api/v1/security/org/head` | [Руководитель команды](https://docs.legalstack.ru/api/security/org/put-security-org-head) |
| `PUT` | `/api/v1/security/org/members/{userId}` | [Место сотрудника в структуре](https://docs.legalstack.ru/api/security/org/put-security-org-members-userid) |
| `POST` | `/api/v1/security/org/units` | [Создать подразделение](https://docs.legalstack.ru/api/security/org/post-security-org-units) |
| `DELETE` | `/api/v1/security/org/units/{id}` | [Удалить подразделение](https://docs.legalstack.ru/api/security/org/delete-security-org-units-id) |
| `PATCH` | `/api/v1/security/org/units/{id}` | [Изменить подразделение](https://docs.legalstack.ru/api/security/org/patch-security-org-units-id) |

### [Приглашения](https://docs.legalstack.ru/api/security/invites)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/api/v1/security/invites` | [Список ожидающих приглашений](https://docs.legalstack.ru/api/security/invites/get-security-invites) |
| `POST` | `/api/v1/security/invites` | [Создать приглашение](https://docs.legalstack.ru/api/security/invites/post-security-invites) |
| `DELETE` | `/api/v1/security/invites/{id}` | [Отменить приглашение](https://docs.legalstack.ru/api/security/invites/delete-security-invites-id) |
| `GET` | `/api/v1/security/invites/{token}` | [Получить приглашение по токену](https://docs.legalstack.ru/api/security/invites/get-security-invites-token) |
| `POST` | `/api/v1/security/invites/{token}/accept` | [Принять приглашение как новый пользователь](https://docs.legalstack.ru/api/security/invites/post-security-invites-token-accept) |
| `POST` | `/api/v1/security/invites/{token}/join` | [Перейти в команду по приглашению](https://docs.legalstack.ru/api/security/invites/post-security-invites-token-join) |

### [OAuth 2.0](https://docs.legalstack.ru/api/security/oauth)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/.well-known/oauth-authorization-server` | [Метаданные сервера авторизации OAuth 2.0 (RFC 8414)](https://docs.legalstack.ru/api/security/oauth/get-well-known-oauth-authorization-server) |
| `GET` | `/.well-known/openid-configuration` | [OpenID Connect Discovery 1.0](https://docs.legalstack.ru/api/security/oauth/get-well-known-openid-configuration) |
| `GET` | `/oauth/authorize` | [Эндпоинт авторизации OAuth 2.0 (RFC 6749 §3.1, PKCE RFC 7636)](https://docs.legalstack.ru/api/security/oauth/get-oauth-authorize) |
| `GET` | `/oauth/authorize/context` | [Контекст экрана согласия OAuth (имя клиента, scopes, redirect_uri)](https://docs.legalstack.ru/api/security/oauth/get-oauth-authorize-context) |
| `POST` | `/oauth/authorize/decision` | [Решение пользователя по экрану согласия OAuth (выдача кода или отказ)](https://docs.legalstack.ru/api/security/oauth/post-oauth-authorize-decision) |
| `POST` | `/oauth/introspect` | [Интроспекция токена (RFC 7662)](https://docs.legalstack.ru/api/security/oauth/post-oauth-introspect) |
| `POST` | `/oauth/register` | [Динамическая регистрация клиента OAuth 2.0 (RFC 7591)](https://docs.legalstack.ru/api/security/oauth/post-oauth-register) |
| `POST` | `/oauth/revoke` | [Отзыв токена (RFC 7009)](https://docs.legalstack.ru/api/security/oauth/post-oauth-revoke) |
| `POST` | `/oauth/token` | [Эндпоинт выдачи токенов OAuth 2.0 (RFC 6749 §3.2)](https://docs.legalstack.ru/api/security/oauth/post-oauth-token) |
| `GET` | `/oauth/userinfo` | [Эндпоинт UserInfo (профиль текущего пользователя)](https://docs.legalstack.ru/api/security/oauth/get-oauth-userinfo) |

### [OAuth-приложения](https://docs.legalstack.ru/api/security/oauth-clients)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/api/v1/security/oauth/clients` | [Список OAuth-клиентов](https://docs.legalstack.ru/api/security/oauth-clients/get-security-oauth-clients) |
| `POST` | `/api/v1/security/oauth/clients` | [Создать OAuth-клиента](https://docs.legalstack.ru/api/security/oauth-clients/post-security-oauth-clients) |
| `DELETE` | `/api/v1/security/oauth/clients/{id}` | [Удалить OAuth-клиента](https://docs.legalstack.ru/api/security/oauth-clients/delete-security-oauth-clients-id) |
| `GET` | `/api/v1/security/oauth/clients/{id}` | [Получить OAuth-клиента](https://docs.legalstack.ru/api/security/oauth-clients/get-security-oauth-clients-id) |
| `PATCH` | `/api/v1/security/oauth/clients/{id}` | [Обновить OAuth-клиента](https://docs.legalstack.ru/api/security/oauth-clients/patch-security-oauth-clients-id) |
| `POST` | `/api/v1/security/oauth/clients/{id}/rotate-secret` | [Сгенерировать новый секрет клиента](https://docs.legalstack.ru/api/security/oauth-clients/post-security-oauth-clients-id-rotate-secret) |

### [Персональные токены](https://docs.legalstack.ru/api/security/personal-tokens)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/api/v1/security/tokens` | [Список персональных токенов](https://docs.legalstack.ru/api/security/personal-tokens/get-security-tokens) |
| `POST` | `/api/v1/security/tokens` | [Создать персональный токен](https://docs.legalstack.ru/api/security/personal-tokens/post-security-tokens) |
| `DELETE` | `/api/v1/security/tokens/{id}` | [Отозвать персональный токен](https://docs.legalstack.ru/api/security/personal-tokens/delete-security-tokens-id) |

### [Каталог OAuth-scopes](https://docs.legalstack.ru/api/security/scopes)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/api/v1/security/scopes` | [Список доступных OAuth-scopes](https://docs.legalstack.ru/api/security/scopes/get-security-scopes) |

### [Единый вход (SSO)](https://docs.legalstack.ru/api/security/sso)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/api/v1/security/admin/sso/providers` | [Список SSO-провайдеров команды](https://docs.legalstack.ru/api/security/sso/get-security-admin-sso-providers) |
| `POST` | `/api/v1/security/admin/sso/providers` | [Создать SSO-провайдер для команды](https://docs.legalstack.ru/api/security/sso/post-security-admin-sso-providers) |
| `DELETE` | `/api/v1/security/admin/sso/providers/{id}` | [Удалить SSO-провайдер](https://docs.legalstack.ru/api/security/sso/delete-security-admin-sso-providers-id) |
| `PUT` | `/api/v1/security/admin/sso/providers/{id}` | [Обновить SSO-провайдер](https://docs.legalstack.ru/api/security/sso/put-security-admin-sso-providers-id) |
| `POST` | `/api/v1/security/admin/sso/providers/{id}/domains` | [Привязать email-домен к SSO-провайдеру](https://docs.legalstack.ru/api/security/sso/post-security-admin-sso-providers-id-domains) |
| `DELETE` | `/api/v1/security/admin/sso/providers/{id}/domains/{domain}` | [Отвязать email-домен от SSO-провайдера](https://docs.legalstack.ru/api/security/sso/delete-security-admin-sso-providers-id-domains-domain) |
| `GET` | `/api/v1/security/sso/callback` | [Завершение входа через OIDC — обмен кода на токены платформы](https://docs.legalstack.ru/api/security/sso/get-security-sso-callback) |
| `GET` | `/api/v1/security/sso/discover` | [Проверить, настроен ли SSO для домена email](https://docs.legalstack.ru/api/security/sso/get-security-sso-discover) |
| `POST` | `/api/v1/security/sso/login/{providerId}` | [Начать вход через OIDC — перенаправление к корпоративному IdP](https://docs.legalstack.ru/api/security/sso/post-security-sso-login-providerid) |

### [Вебхуки](https://docs.legalstack.ru/api/security/webhooks)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/api/v1/webhooks` | [Список эндпоинтов вебхуков](https://docs.legalstack.ru/api/security/webhooks/get-webhooks) |
| `POST` | `/api/v1/webhooks` | [Создать эндпоинт вебхука](https://docs.legalstack.ru/api/security/webhooks/post-webhooks) |
| `DELETE` | `/api/v1/webhooks/{id}` | [Удалить эндпоинт вебхука](https://docs.legalstack.ru/api/security/webhooks/delete-webhooks-id) |
| `GET` | `/api/v1/webhooks/{id}` | [Получить эндпоинт вебхука](https://docs.legalstack.ru/api/security/webhooks/get-webhooks-id) |
| `PATCH` | `/api/v1/webhooks/{id}` | [Обновить эндпоинт вебхука](https://docs.legalstack.ru/api/security/webhooks/patch-webhooks-id) |
| `GET` | `/api/v1/webhooks/{id}/deliveries` | [Список попыток доставки](https://docs.legalstack.ru/api/security/webhooks/get-webhooks-id-deliveries) |
| `POST` | `/api/v1/webhooks/{id}/rotate-secret` | [Сгенерировать новый секрет вебхука](https://docs.legalstack.ru/api/security/webhooks/post-webhooks-id-rotate-secret) |

### [Ключи JWKS](https://docs.legalstack.ru/api/security/jwks)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/.well-known/jwks.json` | [Публичные ключи (JWKS) для токенов доступа и обновления — активный и предыдущий](https://docs.legalstack.ru/api/security/jwks/get-well-known-jwks-json) |
| `GET` | `/.well-known/witness-jwks.json` | [Публичные ключи (JWKS) для witness-токенов (RFC 9068, RFC 9396)](https://docs.legalstack.ru/api/security/jwks/get-well-known-witness-jwks-json) |

### [Контроль доступа](https://docs.legalstack.ru/api/security/access)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/api/v1/security/access-rules` | [Список правил доступа](https://docs.legalstack.ru/api/security/access/get-security-access-rules) |
| `POST` | `/api/v1/security/access-rules` | [Создать правило доступа](https://docs.legalstack.ru/api/security/access/post-security-access-rules) |
| `GET` | `/api/v1/security/access-rules/check` | [Проверка доступа текущего пользователя](https://docs.legalstack.ru/api/security/access/get-security-access-rules-check) |
| `GET` | `/api/v1/security/access-rules/resource/{resourceType}/{resourceId}` | [Правила для конкретного ресурса](https://docs.legalstack.ru/api/security/access/get-security-access-rules-resource-resourcetype-resourceid) |
| `DELETE` | `/api/v1/security/access-rules/{id}` | [Удалить правило доступа](https://docs.legalstack.ru/api/security/access/delete-security-access-rules-id) |
| `PATCH` | `/api/v1/security/access-rules/{id}` | [Обновить правило доступа](https://docs.legalstack.ru/api/security/access/patch-security-access-rules-id) |
| `POST` | `/api/v1/security/access/check-modules` | [Пакетная проверка доступа к модулям](https://docs.legalstack.ru/api/security/access/post-security-access-check-modules) |
| `PUT` | `/api/v1/security/access/groups/{groupId}/modules/{module}` | [Задать группе уровень доступа к разделу](https://docs.legalstack.ru/api/security/access/put-security-access-groups-groupid-modules-module) |
| `GET` | `/api/v1/security/access/modules` | [Уровни доступа текущего пользователя к разделам](https://docs.legalstack.ru/api/security/access/get-security-access-modules) |

### [Агенты](https://docs.legalstack.ru/api/security/agents)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/api/v1/security/agents` | [Агенты команды](https://docs.legalstack.ru/api/security/agents/get-security-agents) |
| `POST` | `/api/v1/security/agents` | [Создать агента](https://docs.legalstack.ru/api/security/agents/post-security-agents) |
| `DELETE` | `/api/v1/security/agents/{agentId}` | [Удалить агента](https://docs.legalstack.ru/api/security/agents/delete-security-agents-agentid) |
| `GET` | `/api/v1/security/agents/{agentId}` | [Агент](https://docs.legalstack.ru/api/security/agents/get-security-agents-agentid) |
| `PATCH` | `/api/v1/security/agents/{agentId}` | [Изменить агента](https://docs.legalstack.ru/api/security/agents/patch-security-agents-agentid) |
| `POST` | `/api/v1/security/agents/{agentId}/default` | [Сделать агента основным](https://docs.legalstack.ru/api/security/agents/post-security-agents-agentid-default) |
| `POST` | `/api/v1/security/agents/{agentId}/resume` | [Возобновить работу агента](https://docs.legalstack.ru/api/security/agents/post-security-agents-agentid-resume) |
| `POST` | `/api/v1/security/agents/{agentId}/suspend` | [Приостановить агента](https://docs.legalstack.ru/api/security/agents/post-security-agents-agentid-suspend) |
| `GET` | `/api/v1/security/agents/{agentId}/versions` | [История версий агента](https://docs.legalstack.ru/api/security/agents/get-security-agents-agentid-versions) |
| `POST` | `/api/v1/security/agents/{agentId}/versions/{version}/restore` | [Вернуть версию агента](https://docs.legalstack.ru/api/security/agents/post-security-agents-agentid-versions-version-restore) |

### [Доступ к агентам](https://docs.legalstack.ru/api/security/agent-access)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/api/v1/security/agents/{agentId}/access` | [Кому открыт доступ к агенту](https://docs.legalstack.ru/api/security/agent-access/get-security-agents-agentid-access) |
| `GET` | `/api/v1/security/agents/{agentId}/access/me` | [Права текущего пользователя на агента](https://docs.legalstack.ru/api/security/agent-access/get-security-agents-agentid-access-me) |
| `DELETE` | `/api/v1/security/agents/{agentId}/access/{subjectType}/{subjectId}` | [Закрыть доступ к агенту](https://docs.legalstack.ru/api/security/agent-access/delete-security-agents-agentid-access-subjecttype-subjectid) |
| `PUT` | `/api/v1/security/agents/{agentId}/access/{subjectType}/{subjectId}` | [Открыть доступ к агенту или изменить роль](https://docs.legalstack.ru/api/security/agent-access/put-security-agents-agentid-access-subjecttype-subjectid) |

### [Лимиты агентов](https://docs.legalstack.ru/api/security/agent-limits)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/api/v1/security/agent-limits/me` | [Мой расход и лимит агента](https://docs.legalstack.ru/api/security/agent-limits/get-security-agent-limits-me) |
| `POST` | `/api/v1/security/agent-limits/me/raise` | [Попросить администраторов увеличить лимит](https://docs.legalstack.ru/api/security/agent-limits/post-security-agent-limits-me-raise) |
| `GET` | `/api/v1/security/agent-limits/team` | [Расход и лимиты агентов команды](https://docs.legalstack.ru/api/security/agent-limits/get-security-agent-limits-team) |
| `PUT` | `/api/v1/security/agent-limits/team/default` | [Задать лимит на сотрудника по умолчанию](https://docs.legalstack.ru/api/security/agent-limits/put-security-agent-limits-team-default) |
| `DELETE` | `/api/v1/security/agent-limits/team/groups/{groupId}` | [Вернуть группе лимит команды](https://docs.legalstack.ru/api/security/agent-limits/delete-security-agent-limits-team-groups-groupid) |
| `PUT` | `/api/v1/security/agent-limits/team/groups/{groupId}` | [Задать лимит на каждого участника группы](https://docs.legalstack.ru/api/security/agent-limits/put-security-agent-limits-team-groups-groupid) |
| `DELETE` | `/api/v1/security/agent-limits/team/members/{userId}` | [Вернуть сотруднику лимит по умолчанию](https://docs.legalstack.ru/api/security/agent-limits/delete-security-agent-limits-team-members-userid) |
| `PUT` | `/api/v1/security/agent-limits/team/members/{userId}` | [Задать сотруднику личный лимит](https://docs.legalstack.ru/api/security/agent-limits/put-security-agent-limits-team-members-userid) |

### [Аудит безопасности](https://docs.legalstack.ru/api/security/audit)

| Метод | Путь | Операция |
| --- | --- | --- |
| `POST` | `/api/v1/security/audit/documents/verify` | [Проверить целостность аудита документов команды (только владелец)](https://docs.legalstack.ru/api/security/audit/post-security-audit-documents-verify) |
| `GET` | `/api/v1/security/audit/me` | [События безопасности текущего пользователя](https://docs.legalstack.ru/api/security/audit/get-security-audit-me) |
| `GET` | `/api/v1/security/audit/team` | [События безопасности команды (только владелец)](https://docs.legalstack.ru/api/security/audit/get-security-audit-team) |
| `POST` | `/api/v1/security/audit/verify` | [Проверить целостность цепочки хешей (только владелец)](https://docs.legalstack.ru/api/security/audit/post-security-audit-verify) |

### [Защита от ботов](https://docs.legalstack.ru/api/security/anti-bot)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/api/v1/security/altcha/challenge` | [Выдать задачу защиты от ботов (proof-of-work)](https://docs.legalstack.ru/api/security/anti-bot/get-security-altcha-challenge) |

### [Поддержка](https://docs.legalstack.ru/api/security/support)

| Метод | Путь | Операция |
| --- | --- | --- |
| `POST` | `/api/v1/security/support/contact` | [Отправить обращение в поддержку](https://docs.legalstack.ru/api/security/support/post-security-support-contact) |