IDEMPOTENCY_KEY_REQUIRED | 400 | Операция требует заголовок Idempotency-Key. | Передайте уникальный ключ в заголовке Idempotency-Key. |
IDEMPOTENCY_KEY_INVALID | 400 | Значение Idempotency-Key не соответствует формату. | Используйте от 8 до 255 символов из набора A-Z, a-z, 0-9 и _ . : + / = -. |
VALIDATION_FAILED | 400 | Параметры или тело запроса не прошли проверку. | Исправьте поля из массива errors: pointer указывает на поле, reason — на причину. |
BAD_REQUEST | 400 | Запрос сформирован некорректно. | Проверьте формат запроса; пояснение — в поле detail. |
NO_TOKEN | 401 | Запрос отправлен без токена доступа. | Передайте токен в заголовке Authorization: DPoP <токен> вместе с заголовком DPoP, см. гайд «Аутентификация». |
INVALID_TOKEN | 401 | Токен недействителен: повреждён, подписан неизвестным ключом, отозван, не привязан к клиенту или вместо токена передан персональный ключ. | Получите новый токен; персональный ключ предварительно обменяйте на токен в POST /oauth/token. |
TOKEN_EXPIRED | 401 | Срок действия токена истёк. | Обновите токен с помощью refresh-токена или получите новый. |
TOKEN_MISSING_TEAM | 401 | Токен выдан без привязки к команде. | Выберите команду и получите токен заново. |
OAUTH_MISSING_TOKEN | 401 | Запрос отправлен без OAuth-токена доступа. | Передайте access token в заголовке Authorization. |
OAUTH_INVALID_SCHEME | 401 | В заголовке Authorization указана неподдерживаемая схема. | Используйте схему DPoP для токена с привязкой к ключу и Bearer для токена с привязкой к mTLS-сертификату. |
OAUTH_INVALID_TOKEN | 401 | OAuth-токен недействителен или отозван. | Получите новый токен. |
OAUTH_DPOP_REQUIRED | 401 | Токен привязан к ключу DPoP, но запрос отправлен без DPoP-доказательства. | Передайте заголовок DPoP с доказательством, сформированным для этого запроса. |
OAUTH_DPOP_SCHEME_MISMATCH | 401 | Схема авторизации не соответствует типу токена. | Передавайте токены с привязкой к ключу со схемой DPoP, токены с привязкой к сертификату — со схемой Bearer. |
OAUTH_INVALID_DPOP_PROOF | 401 | DPoP-доказательство не прошло проверку: подпись, метод, адрес, время или повторное использование. | Сформируйте новое доказательство для этого запроса; если сервер вернул заголовок DPoP-Nonce, включите его значение. |
USE_DPOP_NONCE | 401 | DPoP-доказательство отправлено без актуального серверного nonce или с устаревшим. | Возьмите значение заголовка DPoP-Nonce из этого ответа, включите его в поле nonce нового доказательства и повторите запрос. |
INSUFFICIENT_ROLE | 403 | Роли пользователя в команде недостаточно для операции. | Попросите владельца или администратора команды выдать нужную роль. |
INSUFFICIENT_SCOPE | 403 | Токену не выдан scope, который требует операция. | Запросите токен с нужным scope — он указан у операции в справочнике API. |
TENANT_MISMATCH | 403 | Ресурс принадлежит другой команде. | Проверьте идентификатор ресурса или получите токен нужной команды. |
EMAIL_NOT_VERIFIED | 403 | E-mail пользователя не подтверждён. | Подтвердите e-mail по ссылке из письма. |
OAUTH_INSUFFICIENT_SCOPE | 403 | OAuth-токену не выдан scope, который требует операция. | Запросите токен с нужным scope — он указан у операции в справочнике API. |
PERMISSION_DENIED | 403 | Нет прав на этот ресурс. | Попросите доступ у владельца ресурса или администратора команды. |
NOT_FOUND | 404 | Ресурс не найден или недоступен пользователю. | Проверьте идентификатор ресурса и права доступа. |
METHOD_NOT_ALLOWED | 405 | HTTP-метод не поддерживается для этого адреса. | Проверьте метод операции в справочнике API. |
IDEMPOTENCY_IN_PROGRESS | 409 | Запрос с этим ключом идемпотентности ещё выполняется. | Дождитесь завершения и повторите запрос с тем же ключом, чтобы получить сохранённый ответ. |
IDEMPOTENCY_CONFLICT | 409 | Не удалось определить состояние запроса с этим ключом идемпотентности. | Проверьте результат операции и при необходимости повторите её с новым ключом. |
IDEMPOTENCY_MISMATCH | 409 | Ключ идемпотентности уже использован с другим телом запроса. | Для нового запроса используйте новый ключ; для повтора отправьте то же тело. |
CONFLICT | 409 | Операция конфликтует с текущим состоянием ресурса. | Получите актуальное состояние ресурса и повторите операцию. |
PAYLOAD_TOO_LARGE | 413 | Тело запроса превышает допустимый размер. | Уменьшите размер тела запроса. |
UNPROCESSABLE_ENTITY | 422 | Запрос корректен по формату, но не может быть выполнен. | Устраните причину из поля detail и повторите запрос. |
RATE_LIMITED | 429 | Превышен лимит частоты запросов. | Повторите запрос через число секунд из заголовка Retry-After. |
LLM_QUOTA_EXCEEDED | 429 | Команда исчерпала месячный лимит AI-ассистента. | AI-функции снова заработают с начала следующего месяца. Чтобы увеличить лимит раньше, обратитесь в поддержку. |
PERMISSION_CHECK_FAILED | 500 | Не удалось проверить права доступа из-за временной ошибки. | Повторите запрос позже; если ошибка повторяется — обратитесь в поддержку и укажите request_id. |
INTERNAL | 500 | Внутренняя ошибка сервера. | Повторите запрос позже; если ошибка повторяется — обратитесь в поддержку и укажите request_id. |
UPSTREAM_UNAVAILABLE | 503 | Сервис временно недоступен. | Повторите запрос позже с экспоненциальной паузой. |
CIRCUIT_OPEN | 503 | Сервис временно не принимает запросы из-за сбоев. | Повторите запрос позже с экспоненциальной паузой. |
REQUEST_TIMEOUT | 504 | Сервер не успел обработать запрос. | Повторите запрос; для изменяющих запросов передавайте тот же Idempotency-Key, чтобы операция не выполнилась дважды. |
