# Справочник API

> REST API платформы LegalStack: 20 разделов, 786 операций.

Все публичные операции доступны по адресу `https://api.legalstack.ru`, пути ниже указаны относительно него. Мажорная версия зафиксирована в пути `/api/v1/`, стратегия изменений описана в гайде [Версионирование](https://docs.legalstack.ru/guides/versioning).

## Как вызывать

- Токен передаётся в заголовке `Authorization: Bearer <access_token>`. Как его получить — в [Быстром старте](https://docs.legalstack.ru/intro/quickstart) и гайде [Аутентификация](https://docs.legalstack.ru/guides/authentication).
- Требуемый scope указан у каждой операции в блоке «Авторизация» при выборе схемы `oauth2`; каталог scope — на странице [Каталог OAuth-scopes](https://docs.legalstack.ru/api/security/scopes).
- Ошибки приходят в формате Problem Details, см. гайд [Ошибки](https://docs.legalstack.ru/guides/errors) и [каталог кодов](https://docs.legalstack.ru/errors).
- Лимиты запросов и заголовки `RateLimit` описаны в гайде [Лимиты запросов](https://docs.legalstack.ru/guides/rate-limiting), безопасный повтор изменяющих запросов — в гайде [Идемпотентность](https://docs.legalstack.ru/guides/idempotency).
- Списки и курсоры — в гайде [Пагинация](https://docs.legalstack.ru/guides/pagination), события платформы — в гайде [Вебхуки](https://docs.legalstack.ru/guides/webhooks).

## Разделы

- [Шаблоны](https://docs.legalstack.ru/api/smartdoc): REST API раздела «Шаблоны»: 78 операций.
- [Библиотека шаблонов](https://docs.legalstack.ru/api/templates): REST API раздела «Библиотека шаблонов»: 12 операций.
- [Версии](https://docs.legalstack.ru/api/versioning): REST API раздела «Версии»: 4 операции.
- [Файлы](https://docs.legalstack.ru/api/files): REST API раздела «Файлы»: 21 операция.
- [Интерфейсы](https://docs.legalstack.ru/api/interfaces): REST API раздела «Интерфейсы»: 34 операции.
- [Реестры](https://docs.legalstack.ru/api/registry): REST API раздела «Реестры»: 38 операций.
- [Базы знаний](https://docs.legalstack.ru/api/knowledge): REST API раздела «Базы знаний»: 30 операций.
- [Задачи](https://docs.legalstack.ru/api/tasks): REST API раздела «Задачи»: 35 операций.
- [Календарь](https://docs.legalstack.ru/api/calendar): REST API раздела «Календарь»: 29 операций.
- [Калькуляторы](https://docs.legalstack.ru/api/calculators): REST API раздела «Калькуляторы»: 25 операций.
- [Согласования](https://docs.legalstack.ru/api/approvals): REST API раздела «Согласования»: 18 операций.
- [Подписания](https://docs.legalstack.ru/api/signatures): REST API раздела «Подписания»: 53 операции.
- [Ассистент и агенты](https://docs.legalstack.ru/api/collaboration): HTTP-поверхность realtime-сервиса: AI-беседы, файлы AI-чата, администрирование агентов.
- [Соответствие](https://docs.legalstack.ru/api/compliance): REST API раздела «Соответствие»: 25 операций.
- [Автоматизации](https://docs.legalstack.ru/api/automations): REST API раздела «Автоматизации»: 32 операции.
- [Интеграции](https://docs.legalstack.ru/api/integrations): REST API раздела «Интеграции»: 142 операции.
- [Почта](https://docs.legalstack.ru/api/mail): REST API раздела «Почта»: 7 операций.
- [Telegram](https://docs.legalstack.ru/api/telegram): REST API раздела «Telegram»: 5 операций.
- [Безопасность и доступ](https://docs.legalstack.ru/api/security): REST API раздела «Безопасность и доступ»: 139 операций.
- [Системные агенты](https://docs.legalstack.ru/api/system-agents): Системные агенты платформы: пресеты, общие файлы и навыки. Доступно сотрудникам платформы.

## Машиночитаемые спецификации

Спецификация OpenAPI 3.1 каждого раздела публикуется вместе с документацией и пересобирается из кода при каждом релизе.

| Раздел | Операций | Спецификация |
| --- | --- | --- |
| [Шаблоны](https://docs.legalstack.ru/api/smartdoc) | 78 | [openapi/smartdoc.json](https://docs.legalstack.ru/openapi/smartdoc.json) |
| [Библиотека шаблонов](https://docs.legalstack.ru/api/templates) | 12 | [openapi/templates.json](https://docs.legalstack.ru/openapi/templates.json) |
| [Версии](https://docs.legalstack.ru/api/versioning) | 4 | [openapi/versioning.json](https://docs.legalstack.ru/openapi/versioning.json) |
| [Файлы](https://docs.legalstack.ru/api/files) | 21 | [openapi/files.json](https://docs.legalstack.ru/openapi/files.json) |
| [Интерфейсы](https://docs.legalstack.ru/api/interfaces) | 34 | [openapi/interfaces.json](https://docs.legalstack.ru/openapi/interfaces.json) |
| [Реестры](https://docs.legalstack.ru/api/registry) | 38 | [openapi/registry.json](https://docs.legalstack.ru/openapi/registry.json) |
| [Базы знаний](https://docs.legalstack.ru/api/knowledge) | 30 | [openapi/knowledge.json](https://docs.legalstack.ru/openapi/knowledge.json) |
| [Задачи](https://docs.legalstack.ru/api/tasks) | 35 | [openapi/tasks.json](https://docs.legalstack.ru/openapi/tasks.json) |
| [Календарь](https://docs.legalstack.ru/api/calendar) | 29 | [openapi/calendar.json](https://docs.legalstack.ru/openapi/calendar.json) |
| [Калькуляторы](https://docs.legalstack.ru/api/calculators) | 25 | [openapi/calculators.json](https://docs.legalstack.ru/openapi/calculators.json) |
| [Согласования](https://docs.legalstack.ru/api/approvals) | 18 | [openapi/approvals.json](https://docs.legalstack.ru/openapi/approvals.json) |
| [Подписания](https://docs.legalstack.ru/api/signatures) | 53 | [openapi/signatures.json](https://docs.legalstack.ru/openapi/signatures.json) |
| [Ассистент и агенты](https://docs.legalstack.ru/api/collaboration) | 43 | [openapi/collaboration.json](https://docs.legalstack.ru/openapi/collaboration.json) |
| [Соответствие](https://docs.legalstack.ru/api/compliance) | 25 | [openapi/compliance.json](https://docs.legalstack.ru/openapi/compliance.json) |
| [Автоматизации](https://docs.legalstack.ru/api/automations) | 32 | [openapi/automations.json](https://docs.legalstack.ru/openapi/automations.json) |
| [Интеграции](https://docs.legalstack.ru/api/integrations) | 142 | [openapi/integrations.json](https://docs.legalstack.ru/openapi/integrations.json) |
| [Почта](https://docs.legalstack.ru/api/mail) | 7 | [openapi/mail.json](https://docs.legalstack.ru/openapi/mail.json) |
| [Telegram](https://docs.legalstack.ru/api/telegram) | 5 | [openapi/telegram.json](https://docs.legalstack.ru/openapi/telegram.json) |
| [Безопасность и доступ](https://docs.legalstack.ru/api/security) | 139 | [openapi/security.json](https://docs.legalstack.ru/openapi/security.json) |
| [Системные агенты](https://docs.legalstack.ru/api/system-agents) | 16 | [openapi/system-agents.json](https://docs.legalstack.ru/openapi/system-agents.json) |