Для AI-агентов: markdown этой страницы — /docs-content/changelog/2026-11-19.md индекс документации — /llms.txt

Изменения API: 19 ноября 2026

← Журнал изменений · Ноябрь 2026

NEW-1119-1: ссылки чата

Три новых метода повторяют вкладку «Ссылки» правой панели чата. Нужен скоуп im. Ключ только для чтения читает список и счётчик, а убирать ссылки не может.

Ссылки, отправленные в сообщениях чата: GET /v1/chats/:chatId/links отдаёт страницу ссылок с поиском по адресу, GET /v1/chats/:chatId/links/counter — их число, DELETE /v1/chats/links/:linkId убирает ссылку из списка, сообщение остаётся.

NEW-1119-2: API диктовки сообщает о нехватке ёмкости

Если временно исчерпан общий бюджет загрузок или распознаваний, POST /v1/chats/{dialogId}/messages при вызове команды начала передачи или распознавания отвечает кодом DICTATION_CAPACITY_EXCEEDED с HTTP 429. Заголовок Retry-After указывает рекомендуемое время ожидания в секундах.

NEW-1119-3: Минимальный тариф Коворка для сотрудника

GET /v1/cowork/me и GET /v1/cowork/state возвращают companyMinTier: объект с полем tier (PRO, MAX или ULTRA), если для сотрудника действует минимальный тариф портала, и null в остальных случаях. Поле описывает минимум, а не текущий тариф места.

NEW-1119-4: Тип пользователя в настройках чата профиля

GET /v1/users/me?include=chatConfiguration отдаёт в chatConfiguration.preloadedEntities поле legacyCurrentUser: объект с id вызывающего и его типом type (user, extranet, collaber или guest) — ключом permissions.byUserType. Другие поля записи вызывающего не передаются. Поля нет, если Битрикс24 его не вернул; без include профиль сохраняет прежний состав.

FIX-1119-5: Логи Galaxy-приложения подсказывают доступное действие

Было

При работающем приложении и недоступном хосте GET /v1/infra/servers/:id/logs предлагал пробуждение, хотя POST /v1/infra/servers/:id/wake отвечал 422 SERVER_WRONG_STATE. При отсутствии связанного хоста ответ обещал сохранность логов.

Стало

GET сохраняет HTTP 200 с пустыми логами и не предлагает пробуждение для RUNNING и PROVISIONING до начала выкладки. Если связанный хост не найден, recovery.reasonCode=GALAXY_HOST_NOT_FOUND; в ответе нет адреса пробуждения и обещания сохранности логов. Платная выкладка предлагается только когда она доступна вызывающему и уместна для состояния приложения. Терминальная ошибка хоста отражается кодом GUEST_NOT_BOOTING или GUEST_NO_EGRESS в порядке проверок /wake, без предложения пробуждения или платной выкладки. При GUEST_NOT_BOOTING ответ не обещает сохранность логов и не содержит бюджет холодного запуска при любом статусе приложения; до замены хоста предлагает обратиться в поддержку по поводу извлечения прежних логов. Между чтением и следующим вызовом состояние может измениться.

Повторный /wake или /start SLEEPING-приложения с субдоменом при подтверждённом уже начатом пробуждении возвращает HTTP 200 вместо ошибочного 422, в том числе без отметки о начале выкладки. Ответ /wake содержит текущее состояние, /start сохраняет {success:true}; готовность проверяется опросом. Остальные отказы сохраняются.

NEW-1119-6: коды 409 APPLICATION_MOVE_ACTIVE и APPLICATION_MOVE_RETAINING на время переезда приложения

Пока приложение переезжает на новый сервер, POST /v1/applications/:id/replace-server и операции с его сервером (POST /v1/infra/servers/:id/deploy, exec, upload, удаление, запуск, остановка, сон, пробуждение, перезагрузка, починка, смена порта, режима и доступа) отвечают 409 APPLICATION_MOVE_ACTIVE. В теле ошибки — moveId, status и retryAfter в секундах, тот же срок в заголовке Retry-After: подождите и повторите вызов, новый сервер не создавайте. После переезда прежний сервер хранится для возврата; в это время replace-server отвечает 409 APPLICATION_MOVE_RETAINING с полем keepOldUntil. Прежние вызовы вне переезда работают как раньше.

NEW-1119-7: Поиск V1 принимает `start` для выбора страницы

Тело общего POST /v1/{entity}/search принимает start как синоним offset для выбора страницы. Если указаны оба параметра, действует offset, когда он не равен null, включая значение 0; при offset: null действует start. Для эффективного смещения применяются те же ограничения: UNSUPPORTED_OFFSET на сущностях без смещения и UNSTABLE_OFFSET_PAGINATION при оконном поиске по широкому диапазону дат. Для обычной пагинации такого диапазона можно передать autoWindow:false и явную сортировку.