Для AI-агентов: markdown этой страницы — /docs-content/changelog/2026-11-02.md индекс документации — /llms.txt
Изменения API: 2 ноября 2026
← Журнал изменений · Ноябрь 2026
FIX-1102-1: размещение в галактике больше не отвечает 503 GALAXY_HOST_CREATING
Было
POST /v1/infra/servers с размещением в галактике, пока хост приложения ещё создаётся, отвечал 503 GALAXY_HOST_CREATING с заголовком Retry-After и ничего не создавал.
Стало
Ответа 503 GALAXY_HOST_CREATING больше нет: приложение садится на хост, который ещё создаётся, а деплой ждёт его подключения так же, как для загружающегося хоста. Повторять запрос по Retry-After не нужно.
Если размещение допускает выделенный сервер вместо галактики, отказ облака создать новый хост приложения больше не перенаправляет приложение на выделенный сервер: приложение получает статус error, после чего платформа удаляет и хост, и приложение, не дожидаясь плановой очистки. Повторный запрос размещает приложение заново.
NEW-1102-2: деплой приложения со входом пользователей: имена платформы в env и отказы APP_LOGIN_SERVICE_REQUIRED, APP_LOGIN_INFRA_UNAVAILABLE, APP_LOGIN_STATE_CHANGED
У приложения со входом пользователей (есть системный секрет платформы) POST /v1/infra/servers/{id}/deploy убирает из env имена, которые задаёт платформа: APP_URL, AUTH_TRUST_PROXY, AUTH_DB_ADMINS и все переменные входа VIBE_*. На каждое убранное имя ответ несёт строку в warnings. После аварийной смены секрета входа так же убираются AUTH_SECRET и AUTH_SECRET_PREVIOUS; до неё переданный AUTH_SECRET доставляется, а ответ предупреждает, если приложение уже перешло на SDK 0.4 или ещё получает прежний секрет входа. Деплой отдельной машины такого приложения с "systemd": false или с командой запуска через docker compose или pm2 отвечает HTTP 409 с кодом APP_LOGIN_SERVICE_REQUIRED. Если переменные входа сейчас не собрать (например, у приложения нет адреса), деплой получает HTTP 409 с кодом APP_LOGIN_INFRA_UNAVAILABLE. Оба отказа приходят до замка сервера и до сборки. Если вход пользователей приложения изменился, пока деплой готовился, ответ — HTTP 409 с кодом APP_LOGIN_STATE_CHANGED и retryable: true: ничего не запущено, повторите тот же деплой. То же правило для env действует, когда приложение со входом собирается разовым POST /v1/infra/servers с source и env на свой прежний слот. Отдельной машине такого приложения (вход включён не через пилот) деплой сам добавляет в dataDirs каталог базы входа /var/lib/vauth. В остальном деплой приложений без входа пользователей не меняется — кроме общего для всех каталога /var/lib/vibe/app-login (отдельная запись).
NEW-1102-3: деплой: каталог /var/lib/vibe/app-login зарезервирован платформой
Для всех приложений на отдельной машине extractTo или dataDirs у POST /v1/infra/servers/{id}/deploy, совпадающие с /var/lib/vibe/app-login или пересекающиеся с ним, проваливают деплой на шаге app_secrets с ошибкой SECRET_DIRECTORY_RESERVED — так же, как раньше /var/lib/vibe/app-secrets. Файлы и службы на машине при этом не трогаются: выберите другой путь и задеплойте снова.
NEW-1102-4: приложение со входом пользователей, пока отзыв доступа не применён: перезагрузка с APP_LOGIN_REVOKE_PENDING и деплой с SECRET_REVISION_CHANGED
У приложения со входом пользователей платформа отзывает доступ новой ревизией секретов входа (смена владельцев, восстановление из копии, аварийная смена секрета). Пока такая ревизия не применена, POST /v1/infra/servers/{id}/reboot отвечает HTTP 409 с кодом APP_LOGIN_REVOKE_PENDING — и для отдельной машины, и для приложения Galaxy: перезагрузка подняла бы приложение со старыми настройками входа, поэтому ничего не меняется. Платформа применяет ревизию сама; после применения перезагрузка снова работает. Старт и пробуждение (POST /v1/infra/servers/{id}/start, POST /v1/infra/servers/{id}/wake) приложения Galaxy сначала применяют ревизию: если применить её не удалось, приложение остаётся спящим, а не запускается со старыми настройками входа. Отдельная машина стартует, а ревизию платформа применяет, когда машина снова на связи. Если платформа уже остановила приложение после неудачных применений (APP_LOGIN_REVOCATION_STOPPED), его служба остаётся выключенной до применения. Если отзыв подняли, пока готовился деплой, POST /v1/infra/servers/{id}/deploy не запускает приложение без нового секрета входа: приложение Galaxy получает HTTP 409 с кодом SECRET_REVISION_CHANGED и retryable: true, отдельная машина — DEPLOY_FAILED на шаге app_secrets с error.message SECRET_REVISION_CHANGED и retryable: true. Повторите деплой — он доставит новую ревизию. Для приложений без входа пользователей ничего не меняется.
NEW-1102-5: приложение со входом пользователей не отвязывается от живого сервера при создании нового: APP_LOGIN_SERVER_REQUIRED
Если приложение, которому принадлежит ключ, включило вход пользователей и привязано к живому серверу, который нельзя переиспользовать (слот помощника, общий хост Galaxy, сервер без облачной машины), POST /v1/infra/servers отвечает HTTP 409 с кодом APP_LOGIN_SERVER_REQUIRED: новая машина не создаётся, привязка приложения не меняется. Иначе прежний сервер остался бы работать с ключами входа вне управления платформой. Удалите приложение вместе с сервером или передайте его владельцу сервера. Привязка к удалённому серверу снимается, как раньше. Для приложений без входа пользователей ничего не меняется.
NEW-1102-6: секреты приложения: поле kind и отказ SECRET_SYSTEM
Метаданные секрета в ответах GET /v1/applications/{id}/secrets и POST /v1/applications/{id}/secrets получили поле kind: user — секрет автора приложения, system — секрет входа пользователей, которым управляет платформа. Системные секреты (VIBE_AUTH_SECRET, VIBE_AUTH_SECRET_PREVIOUS, VIBE_AUTH_SECRET_REVOKED) в списке идут первыми и не входят в лимит 100 имён. Создать или удалить такое имя нельзя: POST /v1/applications/{id}/secrets и DELETE /v1/applications/{id}/secrets/{name} отвечают HTTP 409 с кодом SECRET_SYSTEM. Успешный DELETE по-прежнему отвечает secret: null. Ответы для секретов автора не меняются, кроме нового поля kind: "user".
FIX-1102-7: Справочник API описывает поля ответа по каждой операции отдельно
Было
Таблицы полей в справочнике API перечисляли все поля сущности независимо от
операции. В карточках списков и поиска оказывались поля, которых строки списка
не содержат, а поля, не входящие в выборку по умолчанию, показывались как
возвращаемые. Признак необязательного значения терялся: поле, которое может
прийти как null, было описано обычным скалярным типом.
Стало
Таблица полей описывает ту же проекцию, что и пример ответа под ней: карточка
списка или поиска показывает поля строки списка, карточка записи — поля
одиночного ответа, карточка создания и обновления — поля перечитываемой записи.
Поля, которые операция не возвращает, из таблицы убраны; в карточке описания
полей сущности они остаются с прежними признаками. Необязательные поля описаны
как T|null.
Влияние на интеграторов
Поведение API и примеры ответов не изменились. Таблицы точнее описывают, что возвращает конкретная операция.
NEW-1102-8: Каталог `.vauth/` в базе приложения зарезервирован
Методы базы приложения — чтение, изменение, копии и восстановление — возвращают 400 APP_DB_PATH_RESERVED, когда путь к базе в file или в VIBE_DB_PATH контейнера ведёт в каталог .vauth/ внутри /data, в любом регистре букв. Чтение и изменение отказывают так же и при пути через символьную ссылку. В этом каталоге платформа хранит данные входа в приложение. Пути вне .vauth/ работают как раньше.
BC-1102-9: VibeCode Connect не выдаёт приложению ключ с правами записи, если аккаунт Битрикс24 выдаёт новые ключи только для чтения
Поддержка старого формата до: не предусмотрена
Было
Согласие VibeCode Connect выдавало приложению ключ в режиме «чтение и запись» независимо от настройки аккаунта Битрикс24, по которой новые ключи выдаются только для чтения. Сотрудник мог подключить приложение, хотя политика аккаунта этого не разрешала.
Стало
Если аккаунт Битрикс24 выдаёт новые ключи только для чтения, согласие больше не выдаёт партнёрскому приложению ключ с правами записи. Страница согласия показывает отказ с кодом KEY_POLICY_READONLY_REQUIRED и просит включить режим «чтение и запись» у администратора аккаунта. Администратор аккаунта ключ по-прежнему получает. Режим ключа не сужается молча: вместо урезанного ключа приложение получает явный отказ.
Что делать интеграторам
Если ваше приложение работает на аккаунтах Битрикс24, где новые ключи выдаются только для чтения, попросите администратора такого аккаунта включить режим «чтение и запись». Если приложению достаточно чтения, запрашивайте только нужные права и согласуйте политику аккаунта с администратором.
NEW-1102-10: MCP-пакет 3.4.0: HTTP-режим, системные секреты и подсказки по доступу
В @bitrix24/mcp-vibecode-api 3.4.0 исправлен HTTP-режим (--http): сервер отклонял любой запрос с верным токеном ответом 400 Parse error, теперь запросы обрабатываются. Ограничение размера тела запроса сохранено, слишком большое тело получает 413.
Инструмент секретов приложения показывает тип каждой записи — пользовательский или системный (kind). Системные секреты создаёт платформа: их нельзя создать или удалить через MCP, такая попытка возвращает SECRET_SYSTEM. Значения секретов MCP по-прежнему не принимает и не возвращает.
Подсказки по доступу к инфраструктуре различают модели доступа аккаунта: по подписке Marketplace или по тарифу Битрикс24, а также ограниченный доступ. Они объясняют коды INT_TARIFF_REQUIRED и TRIAL_EXPIRED, разделяют пополнение баланса и доступ по тарифу и уточняют, когда помогает подключение своего AI-ключа.
Справочник сущностей описывает методы сквозной аналитики через REST v3: трейсы, источники, каналы, ручные расходы, аналитику источников и рекламные кабинеты. Методы раскатываются вместе с обновлением Битрикс24 и доступны, когда для аккаунта включена функция; до этого вызов отвечает, что метод ещё недоступен. Минимальная версия зависимости undici поднята до 7.30.1. Обновите пакет и перезапустите MCP-сессию, чтобы загрузить новые подсказки.
FIX-1102-11: регистрация бота при обрыве связи после создания отвечает 409, а не 502
Было
Если Битрикс24 уже создал бота, а связь оборвалась на последующей проверке регистрации, POST /v1/bots мог ответить 502 BITRIX_UNAVAILABLE с подсказкой, что запись могла не дойти до Битрикс24. Регистрация при этом завершалась в фоне, и клиент не знал, что бот уже есть.
Стало
В этом случае ответ — 409 BOT_EFFECT_IN_PROGRESS с заголовком Retry-After, как для любой регистрации, которая ещё согласуется. Повтор с тем же кодом или вызов POST /v1/bots/registrations/{code}/recover возвращает ID созданного бота.
Влияние на интеграторов
Клиент, который уже обрабатывает 409 BOT_EFFECT_IN_PROGRESS по документации, ничего не меняет. Повтор с новым кодом после такого ответа не нужен.
FIX-1102-12: Стоимость в статистике AI-вызовов не включает вызовы по квоте и подписке
Было
В ответе GET /v1/ai/usage поля totals.cost, byModel[].cost и recentCalls[].cost включали цену вызовов, покрытых квотой AI компании или подпиской Коворк/Код, хотя за них ничего не списывалось. Вызовы сверх квоты учитывались по цене каталога, а не по фактически списанной сумме.
Стало
Поля cost показывают Вайбы к оплате за вызовы. Вызовы внутри квоты AI компании и по подписке Коворк/Код учитываются как 0, сверх квоты — по фактически списанной сумме. Вызовы, оплачиваемые с кошелька, учитываются по цене каталога, списание происходит раз в сутки и может быть меньше, если у агента действует бесплатный лимит токенов. BYOK — 0.
Влияние на интеграторов
Имена и типы полей сохранены, количество вызовов и токенов не изменилось. Если интеграция складывала cost как расход, сумма теперь совпадает с оплатой. Если cost служил оценкой объёма потребления по каталогу, используйте для этого calls и токены.
NEW-1102-13: признак партнёрского аккаунта в состоянии Коворк/Код
Успешные ответы GET /v1/cowork/me и GET /v1/cowork/state содержат portal.isPartner — логический признак партнёрского (NFR) аккаунта Битрикс24. Поле есть у бесплатных и платных мест; если запись аккаунта отсутствует или удалена, значение — false.
FIX-1102-14: Признак обрезки вывода команд в Galaxy
Было
Синхронный POST /v1/infra/servers/:id/exec для GALAXY_APP возвращал truncated: false, даже когда агент сообщал об обрезке вывода.
Стало
Ответ передаёт truncated: true, если агент сообщил об обрезке. Общий предел stdout и stderr остаётся 1 МиБ. Старые агенты могут не передавать признак; для них false не гарантирует полноту вывода.
FIX-1102-15: самоописание публичной модели скрывается и в рассуждениях AI Router
Было
В ответе POST /v1/chat/completions модель семейства bitrixgpt-* могла назвать свою базовую модель в reasoning_content, хотя в content её имя уже скрывалось.
Стало
В распознаваемых предложениях, где публичная модель говорит о себе, имя её скрытой основы маскируется также в reasoning_content обычного и потокового ответа. Информационные упоминания других моделей без самоописания сохраняются.
Влияние на интеграторов
Формат и успешный статус ответа сохраняются; изменений на стороне клиента не требуется.
FIX-1102-16: Отказ в выписке ключа на облачном RU-портале больше не называет тариф причиной
Было
Когда Битрикс24 отказывал в выписке кодом FEATURE_NOT_AVAILABLE_ON_CURRENT_PLAN на облачном портале региона RU с платным тарифом и действующей подпиской, POST /v1/keys отвечал 502 CONNECTOR_PLAN_REQUIRED и текстом «тариф не включает Вайбкод». Подпись противоречила тому, что человек видел у себя: тариф платный, подписка живая, и причину отказа вендор не назвал.
Стало
При таком отказе на любом облачном портале, определённом платформой как регион RU, ответ остаётся 502, но код нейтральный — CONNECTOR_KEY_ISSUE_FAILED, а текст в userMessage просит повторить попытку. Эта ветка не зависит от платности тарифа или состояния подписки. Успешная выписка остаётся успешной.
Ветку CONNECTOR_PLAN_REQUIRED в своём коде оставьте: при том же отказе ответ 502 CONNECTOR_PLAN_REQUIRED сохраняется у коробочных порталов любого региона, у облачных порталов BY/KZ/UZ с платным тарифом или с неизвестным признаком платности, а также у облачных порталов региона INT, где линейка Vibe+ не предлагается. Для облачных BY/KZ/UZ на бесплатном тарифе возвращается 402 с кодом BY_PAID_ONLY, KZ_PAID_ONLY или UZ_PAID_ONLY соответственно. Для облачного INT, где линейка Vibe+ предлагается, возвращается 402 INT_VIBE_PLUS_REQUIRED независимо от платности тарифа. Если регион определить не удалось, платформа применяет правила INT.
Затронутые эндпоинты: POST /v1/keys, POST /v1/keys/{id}/rotate, POST /v1/apps
BC-1102-17: Персональный лимит серверов
Поддержка старого формата до: не предусмотрена
Было
POST /v1/infra/servers проверял только общий лимит серверов на пользователя для текущего портала.
Стало
Если администратор задал владельцу API-ключа более строгий персональный лимит и он исчерпан, POST /v1/infra/servers возвращает 403 MAX_SERVERS_REACHED, даже когда общий лимит портала ещё не исчерпан. Без персональной настройки продолжает действовать общий лимит портала. Формат запроса и прежний код отказа не изменились; существующие серверы не удаляются.
Что делать интеграторам
При 403 MAX_SERVERS_REACHED уточните персональный лимит у администратора портала, освободите серверный слот или согласуйте повышение лимита.