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

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

### NEW-1112-1: цена кешированного входа в pricing моделей

[GET /v1/models](/docs/ai/models/list) и [GET /v1/models/:modelId](/docs/ai/models/get) возвращают в объекте `pricing` новое поле `cachedPrompt` — стоимость 1М кешированных токенов входа в Вайбах. Поле есть всегда: `null` означает, что отдельной цены нет. Кешированная часть входа (`usage.prompt_tokens_details.cached_tokens`) тарифицируется по `cachedPrompt`, если цена задана, иначе по `prompt`. Запись в кеш отдельно не тарифицируется.

### FIX-1112-2: OpenAPI описывает потоковый ответ чата

**Было**

Для `POST /v1/chat/completions` и устаревшего `POST /v1/ai/chat/completions` схема успешного ответа указывала только `application/json`, хотя `stream: true` включает потоковую передачу.

**Стало**

Схема объявляет оба формата: `application/json` для обычного ответа и `text/event-stream` для `stream: true`. Формат обычного ответа сохранён. [Потоковая передача](/docs/ai/chat/streaming).

### FIX-1112-3: MCP save_sources передаёт Unicode-заметки

**Было**

В `@bitrix24/mcp-vibecode-api` инструмент `save_sources` завершался локальной ошибкой `NETWORK_ERROR`, если `note` содержала символы выше U+00FF, например кириллицу. Запрос сохранения снимка не отправлялся. Заметка с символами из диапазона U+0080–U+00FF, например «é», сохранялась с искажёнными символами.

**Стало**

Начиная с версии 3.4.2 любая заметка передаётся UTF-8-байтами в `X-Note` при вызове [`POST /v1/infra/servers/:serverId/sources`](/docs/source-storage) или [`POST /v1/apps/:appId/sources`](/docs/source-storage) и сохраняется без искажений. Заметки из ASCII передаются как прежде. CR/LF по-прежнему отклоняются.

**Влияние на интеграторов**

Для исправления требуется обновить MCP-пакет. Схемы и ответы API не изменены.

### NEW-1112-4: Снятие запланированной отмены подписки Коворк/Код

`POST /v1/cowork/subscription/resume` со скоупом `vibe:cowork` снимает запланированную отмену активной подписки Коворк/Код для пользователя и аккаунта, привязанных к ключу. Списания нет, оплаченный период, дата следующего списания и квоты сохраняются. При успехе `state.subscription.cancelAtPeriodEnd` равен `false`. Вызывайте метод только после подтверждения пользователя.

### NEW-1112-5: Комментарии к рабочим отчётам и рабочим дням

[GET /v1/workday/work-reports/:id/comments](/docs/workday/work-reports/comments) и [GET /v1/workday/records/:recordId/comments](/docs/workday/records-comments) читают обсуждения отчёта и рабочего дня. Прежнее чтение отчётов и рабочих дней сохраняет поведение.

В процессе раскатки: целевая версия — `timeman 26.600.0`. Новое чтение требует отдельного включения на платформе Вайбкод и обновления на портале. До включения или при отсутствии метода возвращается `422 METHOD_NOT_YET_AVAILABLE`; версия исходников сама по себе не означает, что обновление уже доступно на портале.

### FIX-1112-6: проверки деплоя обращаются к приложению как браузер

**Было**

Шаги `healthcheck` и `app_root` в `POST /v1/infra/servers/:id/deploy` и проверка внутри контейнера galaxy-приложения отправляли запрос без `Accept: text/html`. Приложение, которое браузеру отдаёт страницу, а API-запросу без сессии отвечает 503, получало `DEPLOY_FAILED` на шаге `healthcheck`, хотя страница работала.

**Стало**

Все три проверки отправляют `Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8` — так Битрикс24 открывает приложение. Приложение проверяется по ответу браузеру. Эндпоинт, который отвечает только JSON, заголовок не задевает: в нём есть `*/*`. Успешный ответ HTTP 200 деплоя не меняется.

### NEW-1112-7: поле appUserSignIn.guidance в ответе /v1/me

В группе `data.capabilities.appUserSignIn` ответа `GET /v1/me` появилось поле `guidance` — `{ text }` или `null`. В `text` лежит английский текст для инструкций агента: принципы входа пользователей в приложение (не писать свой вход и не хранить пароли) и вопрос автору «кто будет пользоваться приложением» с ветками ответа. Текст зависит от того, какие возможности входа доступны владельцу ключа; вставляйте его в инструкции агента как есть. На платформе Вайбкод поле заполнено всегда, в том числе пока настройка входа через SDK владельцу ключа недоступна. Остальные поля ответа не меняются.

### FIX-1112-8: статус входа пользователей не ждёт мастера, когда версия SDK неизвестна

**Было**

`GET /v1/app-user-signin/servers/{serverId}/status` отвечал `setup_pending` в поле `state` и в `lastKnown.outcome`, когда SDK входа сообщал, что вход посетителей закрыт до мастера, а версию SDK в приложении платформа не знала. Так было даже для приложения на SDK 0.4.0, где мастера нет.

**Стало**

`setup_pending` приходит, только когда платформа знает, что в приложении SDK входа 0.4.1 или новее. Версию SDK платформа берёт из последнего архива приложения, который она прочитала при деплое, поэтому не каждый деплой её обновляет: например, деплой по ссылке или по сохранённой версии исходников оставляет прежнюю. Если версия неизвестна или младше 0.4.1, тот же случай читается как `not_configured`.

**Влияние на интеграторов**

Менять ничего не нужно: оба значения по-прежнему означают, что вход установлен, но пока закрыт.

### FIX-1112-9: MCP-пакет 3.4.3: проверка входа без повторных деплоев

**Было**

В `@bitrix24/mcp-vibecode-api` 3.4.1 и 3.4.2 сценарий `add-user-login` при состоянии `not_configured` считал, что в приложении SDK входа 0.4.0, и советовал задеплоить приложение со способом входа и политикой в переменных. Если в приложении уже был SDK 0.4.1 или новее, а платформа не прочитала его версию, этот совет не помогал, и агент мог деплоить приложение снова и снова.

**Стало**

Агент сверяет версию SDK входа в lock-файле приложения (`package-lock.json`, `pnpm-lock.yaml` или `yarn.lock`). Для SDK 0.4.0 совет прежний. Для 0.4.1 и новее агент не меняет переменные и не переустанавливает SDK: делает один деплой с архивом приложения в `source.content` и через минуту проверяет вход снова. Если состояние не изменилось, агент больше не деплоит, объясняет автору, почему платформа не прочитала версию (lock-файл должен лежать в корне архива, не во вложенной папке, и быть меньше 4 МиБ), и даёт ссылку на мастер из шага `create-admin`.

**Влияние на интеграторов**

Обновите пакет и перезапустите MCP-сессию, чтобы загрузить новую подсказку.

### NEW-1112-10: методы базы знаний сообщают точную версию доступности

Для 14 поздних методов `note.*` API сообщает точную версию доступности через `error.release`, если метода ещё нет на портале. Пороги: `note 26.200.0` для операций записи, получения коллекции и файлов, `note 26.500.0` для перемещения коллекций и документов, `note 26.700.0` для [GET /v1/note/documents](/docs/note/documents/list). Успешный ответ остаётся HTTP 200.

Методы в процессе раскатки. До обновления модуля на портале ответ `422 METHOD_NOT_YET_AVAILABLE` означает, что метод ещё не раскатан, а не ошибку интеграции.

### FIX-1112-11: действия с чек-листом возвращают 404 при отказе доступа

**Было**

На новых версиях Битрикс24 действия с пунктом чек-листа и сохранение дерева могли возвращать HTTP 422 `BITRIX_ERROR` при отказе доступа к задаче или пункту.

**Стало**

Действия с пунктом чек-листа возвращают HTTP 404 `NOT_FOUND` для такого отказа. [Сохранение дерева чек-листа](/docs/entities/tasks/checklist-actions/tree) через `POST /v1/tasks/:taskId/checklist/tree` возвращает HTTP 404 `TASK_NOT_FOUND` для того же отказа, в том числе вызванного неверным ID или NODE_ID пункта в теле запроса. Распознаются точные тексты отказа на русском, английском, немецком и казахском языках.

### BC-1112-12: Отказ Битрикс24 при запросе полей неподдерживаемого типа CRM

> Поддержка старого формата до: не предусмотрена

**Было**

Запрос `GET /v1/items/{entityTypeId}/fields` после отказа Битрикс24 `ENTITY_TYPE_NOT_SUPPORTED` возвращал HTTP 200 со статическими полями и предупреждением `fields_partial`.

**Стало**

Этот отказ передаётся штатному обработчику ошибок. Для стандартного бизнес-отказа это `422 BITRIX_ERROR`, исходный код Битрикс24 в `error.b24Code` и сообщение в `error.message`. Существующие приоритеты обработки других сочетаний кода, текста и статуса Битрикс24 сохраняются. Успешный ответ с полями после такого отказа больше не возвращается. Другие ошибки получения полей сохраняют прежний частичный ответ.

**Что делать интеграторам**

Обрабатывайте HTTP 422 при запросе полей и проверяйте `error.b24Code`. Не считайте статические поля подтверждением доступности типа CRM. Обработка batch и import не меняется.

### NEW-1112-13: включение входа пользователей приложения по ключу API

Новый метод `POST /v1/app-user-signin/servers/{serverId}/enable` включает вход пользователей в приложении на этом сервере — то же, что кнопка «Включить вход» в карточке приложения. Платформа сама заводит секрет и служебные переменные входа и передаёт их приложению при следующем деплое, поэтому `AUTH_SECRET` задавать не нужно. Ответ — `{ result, mode, cabinetUrl, setup }`: `result` равен `enabled` или `already_enabled` (повторный вызов ничего не меняет), `mode` — `new` для нового входа, `pilot` для приложения, которое уже работало на входе 0.3 (его прежний `AUTH_SECRET` платформа переносит сама), или `null` при `already_enabled`, `setup` — тот же объект, что у `GET /v1/app-user-signin/servers/{serverId}/setup`, с шагами `enableFlow` по порядку, а `cabinetUrl` ведёт в карточку приложения. Секретов в ответе нет.

Вызывать метод может владелец ключа, которому принадлежат и сервер, и приложение, любым своим ключом с `vibe:infra` в этом Битрикс24. Ключ авторизации приложения подходит только для своего приложения. Тело запроса пустое или `{}`, любое поле — `400 VALIDATION_ERROR`. Чужой сервер, чужое приложение и ключ другого приложения получают одинаковый `404 SERVER_NOT_FOUND`, ключ в режиме только чтения — `403 WRITE_BLOCKED_READONLY_KEY`. Сервер без карточки приложения — `409 APP_LOGIN_NO_APPLICATION`, остальные причины, по которым вход сейчас не включить, — `409` с кодом и готовым текстом для автора в `error.userMessage`. У метода свой лимит запросов, превышение — `429`.

В `GET /v1/me` появился слот `capabilities.appUserSignIn.enable`: он говорит, доступен ли метод этому ключу. Пока функция не включена для владельца ключа, метод отвечает `404 ROUTE_NOT_FOUND`, а слот закрыт.

### NEW-1112-14: замена сервера приложения со входом пользователей меняет секрет входа, если прежний сервер чужой

[POST /v1/applications/{id}/replace-server](/docs/applications/replace-server) у приложения со входом пользователей (есть системный секрет платформы) проверяет владельца прежнего сервера. Если он не владелец карточки, замена вместе с переносом меняет секрет входа: секрет из окружения прежнего сервера перестаёт действовать, сессии пользователей приложения завершаются, админка входа открыта только владельцам приложения. Ответ остаётся HTTP 200 с прежними полями. Если приложение переведено со входа 0.3, а его запуск на SDK 0.4 не подтверждён, секрет сменить нельзя: ответ — HTTP 409 с кодом `APP_LOGIN_SDK_NOT_CONFIRMED`, ничего не меняется. Приложения без входа и замены, где прежний сервер принадлежит владельцу карточки, работают как раньше.
