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

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

### 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/` в базе приложения зарезервирован

Методы базы приложения — [чтение](/docs/infra/database/query), [изменение](/docs/infra/database/execute), [копии](/docs/infra/database/snapshot) и [восстановление](/docs/infra/database/restore) — возвращают `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](/docs/bots/management/create) мог ответить `502 BITRIX_UNAVAILABLE` с подсказкой, что запись могла не дойти до Битрикс24. Регистрация при этом завершалась в фоне, и клиент не знал, что бот уже есть.

**Стало**

В этом случае ответ — `409 BOT_EFFECT_IN_PROGRESS` с заголовком `Retry-After`, как для любой регистрации, которая ещё согласуется. Повтор с тем же кодом или вызов [POST /v1/bots/registrations/{code}/recover](/docs/bots/management/registrations-recover) возвращает ID созданного бота.

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

Клиент, который уже обрабатывает `409 BOT_EFFECT_IN_PROGRESS` по документации, ничего не меняет. Повтор с новым кодом после такого ответа не нужен.

### FIX-1102-12: Стоимость в статистике AI-вызовов не включает вызовы по квоте и подписке

**Было**

В ответе [GET /v1/ai/usage](/docs/ai/consumption/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](/docs/infra/deploy/exec) для `GALAXY_APP` возвращал `truncated: false`, даже когда агент сообщал об обрезке вывода.

**Стало**

Ответ передаёт `truncated: true`, если агент сообщил об обрезке. Общий предел `stdout` и `stderr` остаётся 1 МиБ. Старые агенты могут не передавать признак; для них `false` не гарантирует полноту вывода.

### FIX-1102-15: самоописание публичной модели скрывается и в рассуждениях AI Router

**Было**

В ответе [POST /v1/chat/completions](/docs/ai/chat/completions) модель семейства `bitrixgpt-*` могла назвать свою базовую модель в `reasoning_content`, хотя в `content` её имя уже скрывалось.

**Стало**

В распознаваемых предложениях, где публичная модель говорит о себе, имя её скрытой основы маскируется также в `reasoning_content` обычного и потокового ответа. Информационные упоминания других моделей без самоописания сохраняются.

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

Формат и успешный статус ответа сохраняются; изменений на стороне клиента не требуется.

### FIX-1102-16: Отказ в выписке ключа на облачном RU-портале больше не называет тариф причиной

**Было**

Когда Битрикс24 отказывал в выписке кодом `FEATURE_NOT_AVAILABLE_ON_CURRENT_PLAN` на облачном портале региона RU с платным тарифом и действующей подпиской, [POST /v1/keys](/docs/management-keys/create) отвечал `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](/docs/management-keys/create), [POST /v1/keys/{id}/rotate](/docs/management-keys/rotate), [POST /v1/apps](/docs/apps/create)

### BC-1102-17: Персональный лимит серверов

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

**Было**

[POST /v1/infra/servers](/docs/infra/servers/create) проверял только общий лимит серверов на пользователя для текущего портала.

**Стало**

Если администратор задал владельцу API-ключа более строгий персональный лимит и он исчерпан, [POST /v1/infra/servers](/docs/infra/servers/create) возвращает `403 MAX_SERVERS_REACHED`, даже когда общий лимит портала ещё не исчерпан. Без персональной настройки продолжает действовать общий лимит портала. Формат запроса и прежний код отказа не изменились; существующие серверы не удаляются.

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

При `403 MAX_SERVERS_REACHED` уточните персональный лимит у администратора портала, освободите серверный слот или согласуйте повышение лимита.
