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

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

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

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

GET /v1/models и GET /v1/models/:modelId возвращают в объекте 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. Формат обычного ответа сохранён. Потоковая передача.

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 или POST /v1/apps/:appId/sources и сохраняется без искажений. Заметки из 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 и GET /v1/workday/records/:recordId/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. Успешный ответ остаётся HTTP 200.

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

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

Было

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

Стало

Действия с пунктом чек-листа возвращают HTTP 404 NOT_FOUND для такого отказа. Сохранение дерева чек-листа через 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 у приложения со входом пользователей (есть системный секрет платформы) проверяет владельца прежнего сервера. Если он не владелец карточки, замена вместе с переносом меняет секрет входа: секрет из окружения прежнего сервера перестаёт действовать, сессии пользователей приложения завершаются, админка входа открыта только владельцам приложения. Ответ остаётся HTTP 200 с прежними полями. Если приложение переведено со входа 0.3, а его запуск на SDK 0.4 не подтверждён, секрет сменить нельзя: ответ — HTTP 409 с кодом APP_LOGIN_SDK_NOT_CONFIRMED, ничего не меняется. Приложения без входа и замены, где прежний сервер принадлежит владельцу карточки, работают как раньше.