Для AI-агентов: markdown этой страницы — /docs-content/changelog/2026-10-29.md индекс документации — /llms.txt
Изменения API: 29 октября 2026
← Журнал изменений · Октябрь 2026
NEW-1029-1: Источники и каналы сквозной аналитики
Через API Вайбкод можно читать источники и каналы, создавать и изменять свои источники, отправлять их в архив и возвращать из архива. Встроенный источник доступен по коду, даже если ещё не настроен.
Методы в процессе раскатки с обновлением crm 26.2100.0. Маршруты работают под флагом crm-tracking-v3 и включатся вместе с возможностью Битрикс24. Пока метод недоступен, ответ — 422 METHOD_NOT_YET_AVAILABLE.
FIX-1029-2: список рабочих групп доступен без изображения группы
Было
Запрос GET /v1/me/workgroups завершался HTTP 502 BITRIX_UNAVAILABLE, если Битрикс24 возвращал null вместо ссылки на изображение хотя бы одной группы.
Стало
Группа без изображения остаётся в полном списке. Отсутствующая или пустая ссылка, включая null, возвращается как groupImage: ""; пустой идентификатор изображения — как groupImageId: 0, а пустой признак экстранета — как isExtranet: false. Непустой идентификатор изображения сохраняется даже без ссылки.
Влияние на интегратора
Менять обработку ответа не нужно: типы полей сохранены. Пустое изображение больше не мешает получить остальные группы.
FIX-1029-3: Схема воронок описывает isSystem и отсутствие createdDate
Было
Поле isSystem воронок контактов и компаний приходило в ответах, но не было описано в схеме воронки, и select=isSystem давал предупреждение UNKNOWN_SELECT_FIELD. Поле createdDate было описано в схеме как обычное, хотя Битрикс24 его не возвращает.
Стало
isSystem описан в схеме и в OpenAPI строкой Y или N, как его отдаёт Битрикс24, и выбирается в select без предупреждения. Значение в ответе не изменилось. Запись isSystem, как и раньше, уходит в Битрикс24 без изменений: создать воронку с isSystem: "Y" Битрикс24 не даёт, а при обновлении поле не применяет. Схема и документация теперь говорят об этом прямо. createdDate помечен notReturned: true, в OpenAPI — x-notReturned: true. Запрос с select=createdDate по-прежнему отвечает HTTP 200, а в meta.warnings приходит UNKNOWN_SELECT_FIELD.
Влияние на интеграторов
Менять ничего не нужно. Не стройте сортировку и отображение на createdDate: значения у этого поля нет.
FIX-1029-4: регистрация бота не обещает повтор, если ожидание ничего не изменит
Было
Когда регистрация бота останавливалась на состоянии, которое не исправится само, POST /v1/bots отвечал 409 BOT_EFFECT_IN_PROGRESS с заголовком Retry-After. Повтор через указанное время получал тот же ответ, и так без предела. Такие состояния — например, код, занятый ботом с другим идентификатором, или отозванные права ключа на запись.
Стало
Такой отказ приходит как 409 BOT_UNAVAILABLE без заголовка Retry-After. Отказы, которые снимаются собственной работой платформы, по-прежнему приходят как 409 BOT_EFFECT_IN_PROGRESS с Retry-After: эта ветка не изменилась.
Влияние на интеграторов
Обрабатывайте BOT_UNAVAILABLE как требующий вмешательства: не повторяйте запрос по таймеру, а проверьте, не занят ли код другим ботом, и права ключа на запись. Ответ с BOT_EFFECT_IN_PROGRESS и заголовком Retry-After обрабатывается как прежде.
NEW-1029-5: Свой домен сервера через API
Собственный домен приложения теперь подключается по API-ключу, без кабинета. POST /v1/infra/servers/:id/domain привязывает домен и возвращает DNS-записи, которые нужно создать у DNS-провайдера: тип, имя относительно зоны и значение. GET /v1/infra/servers/:id/domain отдаёт состояние домена и те же записи. POST /v1/infra/servers/:id/domain/verify проверяет записи и включает домен, в ответе статус по каждой записи. DELETE /v1/infra/servers/:id/domain отвязывает домен.
Вызывать операции может только ключ, который управляет сервером, остальным ключам они отвечают 404 SERVER_NOT_FOUND. Привязка, проверка и отвязка требуют скоупа vibe:infra. Пока функция не включена для владельца сервера, привязка и проверка отвечают 403 CUSTOM_DOMAINS_DISABLED, для региона аккаунта Битрикс24 без поддержки своих доменов — 403 CUSTOM_DOMAINS_ZONE_UNSUPPORTED, без коммерческого тарифа — 403 CUSTOM_DOMAINS_REQUIRE_COMMERCIAL.
Проверка ограничена пятью вызовами в минуту. Если записи не сошлись, она отвечает 422 DOMAIN_VERIFICATION_FAILED, а поле error.details.hint объясняет, когда её повторять: изменение DNS публикуется не сразу, и повтор без паузы вернёт тот же результат.
BC-1029-6: Подписанные ссылки на ресурсы и блокировка обновления токенов
Поддержка старого формата до: не предусмотрена
Было
POST /v1/infra/servers/:id/access-tokens/:tokenId/refresh мог отвечать 200, если текущий или записанный прежний издатель api-bearer заблокирован, но сам токен ещё не отозван.
Стало
В этом случае обновление токена отвечает 403 KEY_BLOCKED. Прежний успешный ответ не поддерживается. Штатная ротация ключа без блокировки издателя сохраняет возможность обновления действующего токена.
Добавлено
POST /v1/infra/servers/:id/access-tokens/:tokenId/resource-url выдаёт ссылку для GET/HEAD одного CSS, изображения или шрифта на основе существующего токена api-bearer. Ссылка привязана к пути и приложению, действует до 30 дней, но не дольше родителя, и закрывается при его отзыве. Для виджета Главной с доступом PORTAL используйте подписанный URL стиля и отдельные подписанные URL его изображений; обновляйте регистрацию до истечения срока. Пользовательская сессия для загрузки этих ресурсов не требуется.
Если текущий или записанный прежний издатель заблокирован, выдача ссылки отклоняется с 403 KEY_BLOCKED.
Временно недоступный ресурс возвращает 503 BH_RESOURCE_UNAVAILABLE. Отозванная или недействительная ссылка возвращает 401 BH_RESOURCE_URL_INVALID без перехода к браузерной сессии или публичному доступу.
Что делать интеграторам
Выпустите новый api-bearer незаблокированным управляющим ключом и замените токен в клиенте. Повторное обновление прежнего токена не устраняет KEY_BLOCKED.
NEW-1029-7: Рекламные кабинеты сквозной аналитики
Через API можно получать ссылку авторизации, читать и подключать рекламные кабинеты источника сквозной аналитики, отключать кабинет, читать дерево рекламы и выполнять построение отчёта о расходах по одному шагу. Продолжение дерева возвращается курсором. Готовность отчёта определяется полем complete.
Методы в процессе раскатки с обновлением crm 26.2100.0. Маршруты за флагом crm-tracking-v3 включатся вместе с возможностью Битрикс24. До включения API отвечает 422 METHOD_NOT_YET_AVAILABLE.
NEW-1029-8: Ручные расходы и отчёт по источникам сквозной аналитики
Через API Вайбкод можно добавлять, читать и удалять ручные расходы, а также получать отчёт по источникам. Сумма расходов передаётся в единицах выбранной валюты. Расходы рекламных интеграций этим удалением не затрагиваются.
Методы в процессе раскатки с обновлением crm 26.2100.0. Маршруты работают под флагом crm-tracking-v3 и включатся вместе с возможностью Битрикс24. Пока метод недоступен, ответ — 422 METHOD_NOT_YET_AVAILABLE.
FIX-1029-9: повторный вход в Коворк/Код сохраняет прежний ключ до подтверждения нового
Было
При повторном входе через код устройства прежний ключ установки отзывался сразу после одобрения Connect. Десктоп мог потерять вход до сохранения нового ключа.
Стало
Для десктопа 14.0.94 и новее, передавшего версию и идентификатор установки при начале входа, прежний ключ действует до первого успешного GET /v1/cowork/me новым ключом. Предварительные запросы профиля не подтверждают замену. Неподтверждённый ключ остаётся рабочим без отдельного срока действия. Сбой подтверждения не меняет успешный ответ подписки: подтверждение повторяется следующим запросом.
FIX-1029-10: Временная пауза после повторных отказов доступа к Битрикс24
Было
После повторных ответов 401 ACCESS_DENIED от Битрикс24 запросы с тем же ключом продолжали получать отказы доступа без временной паузы.
Стало
После повторных отказов доступа к разным REST-методам запросы к Битрикс24 с этим ключом временно приостанавливаются. Одиночная операция и глобальный POST /v1/batch, когда отказ блокирует вызов на уровне конверта, возвращают 429 ERROR_LOOP_DETECTED с reason: TEMPORARY_REST_ACCESS_DENIED; заголовок Retry-After и поле retryAfter содержат одинаковое число секунд до следующей проверки. Отказ авто-пагинируемого подвызова глобального batch и отказ читающего действия POST /v1/{entity}/batch остаются в слоте подвызова при внешнем HTTP 200 и содержат retryAfter; у этих ответов нет внешнего Retry-After. Отказ пишущего действия entity batch блокирует весь запрос и возвращается конвертом HTTP 429 с Retry-After и retryAfter. По истечении паузы API автоматически проверяет доступ при следующем запросе. Если доступ восстановлен, запросы возобновляются.
Затронутые эндпоинты: публичные операции, которые выполняют REST-вызов Битрикс24 с этим обычным API-ключом, включая GET /v1/users, POST /v1/batch и пакетные операции сущностей. Одиночный вызов и отказ глобального batch на уровне конверта возвращают HTTP 429; отказ авто-пагинируемого подвызова глобального batch и отказ читающего действия entity batch возвращаются в слоте при HTTP 200 с retryAfter и без внешнего Retry-After. Отказ пишущего действия entity batch возвращает HTTP 429 с внешним Retry-After и полем retryAfter. Операции без REST-вызова через этот ключ не затрагиваются.
Влияние на интеграторов
Изменения интеграции и ручное включение ключа не требуются.