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

[← Журнал изменений](/docs/changelog) · [Ноябрь 2026](/docs/changelog/2026-11)

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

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

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

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

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

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

[GET /v1/cowork/me](/docs/cowork/me) и [GET /v1/cowork/state](/docs/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` и явную сортировку.
