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

Изменения API: 28 октября 2026

← Журнал изменений · Октябрь 2026

FIX-1028-1: Нейтральная диагностика ошибок создания серверов

Было

GET /v1/infra/servers и GET /v1/infra/servers/:id могли возвращать незаявленные коды и технические описания ошибок создания.

Стало

Такие ошибки возвращаются как provisionErrorCode: "GENERIC" с нейтральным provisionError в карточках владельца и участников команды. Перед повторным созданием обратитесь в поддержку. Публичные категории ошибок пробуждения и причины удержания создания сохраняются.

FIX-1028-2: счётчики сделок по смыслу стадии отвечают без номера воронки

Было

POST /v1/deals/aggregate с count и groupBy: "stageSemanticId" попадал в режим счётчиков по стадиям только при скалярном categoryId в фильтре. Без него или со списком воронок запрос больше чем на 5000 сделок отвечал 422 AGGREGATION_LIMIT_EXCEEDED либо усечённым ответом, даже на аккаунте, где этот режим включён.

Стало

На аккаунте с включённым режимом счётчиков по стадиям такой запрос отвечает точными группами P / S / F с meta.aggregatePath: "fanout" и meta.recordsProcessed: 0 при любом условии на categoryId или без него. Группировке по stageId по-прежнему нужен скалярный categoryId.

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

Действий не требуется. Сводку «в работе / успех / провал» по всем воронкам можно получить одним запросом вместо трёх отдельных count.

FIX-1028-3: ключ выпускается на облачном аккаунте Битрикс24, подключённом без Битрикс24 Нетворк

Было

Облачный аккаунт Битрикс24, который подключили к платформе из самого Битрикс24 (из встроенного приложения или входом в кабинет), не связан с Битрикс24 Нетворк. На таком аккаунте POST /v1/keys, POST /v1/cowork/applications и POST /v1/cowork/applications/:id/key отвечали 400 PORTAL_NOT_LINKED, хотя модуль Вайбкод на аккаунте мог выпустить ключ сам.

Стало

Ключ на таком аккаунте выпускает модуль Вайбкод, и запрос завершается успешно. 400 PORTAL_NOT_LINKED остаётся только для аккаунта, где модуль выпустить ключ не может, а связи с Битрикс24 Нетворк нет.

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

Действий не требуется. Если на PORTAL_NOT_LINKED вы просили пользователя войти через Битрикс24 Нетворк, повторите запрос: теперь он может пройти без этого шага.

FIX-1028-4: выкладка продолжается, когда сервер уже готов

Было

POST /v1/infra/servers/:id/deploy мог завершиться с BOOTSTRAP_PROBE_FAILED, хотя сервер уже был готов.

Стало

В этом случае выкладка продолжается. Действительно неверный ответ проверки готовности по-прежнему останавливает выкладку.

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

Запрос и формат ответа не меняются. Действий не требуется.

FIX-1028-5: apps.create отражает доступ к выпуску нового ключа

Было

GET /v1/me показывал capabilities.apps.create.available: true даже тогда, когда POST /v1/apps отказывал в выпуске нового ключа. Примечания о публикации и привязке приложения утверждали, что создание доступно при любом тарифе.

Стало

capabilities.apps.create учитывает доступность выпуска нового ключа. При отказе слот содержит причину. Для ключа Коворк/Код он отражает первую проверку POST /v1/apps и дополнительно сообщает об ограничении выпуска ключа, в том числе о требовании подписки Marketplace. Примечания о публикации и привязке разделяют требования Bitrix24 и ограничения серверной инфраструктуры.

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

Перед вызовом POST /v1/apps проверяйте capabilities.apps.create и учитывайте reason при available: false. После изменения доступа или ключа повторите проверку либо вызовите POST /v1/apps: слот использует кэшированный снимок, а маршрут принимает окончательное решение по текущему состоянию.

FIX-1028-6: ID файлов комментария снова приходят в attach

Было

GET /v1/posts/comments возвращал attach: [] у каждого комментария, даже когда к нему прикреплены файлы. Файлы приходили в data.files, но связать их с комментарием по ответу было нельзя.

Стало

attach содержит ID прикреплённых файлов числами, например [10893, 10895]. Это ключи data.files. У комментария без файлов attach по-прежнему пустой массив.

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

Менять ничего не нужно. Чтобы найти файлы комментария, берите из data.files записи с ключами из attach.

NEW-1028-7: Источник номера владельца ключа

GET /v1/me возвращает owner.userIdSource: webhook или portal-membership, когда доступен owner.userId. Номер передаётся строкой. Ключ Коворк/Код без вебхука может получить закреплённый номер сотрудника из участия в Битрикс24. Это не даёт доступа к данным: при b24Credentials.ready: false вызовы возвращают 401 TOKEN_MISSING.

NEW-1028-8: Смещение следующей страницы списков

GET /v1/lists и GET /v1/lists/:iblockId/elements возвращают необязательное числовое поле meta.next из ответа Битрикс24. Передавайте его как следующий start. На последней странице поле отсутствует. Для элементов списков документация уточняет шаг 50 и округление смещения вниз до кратного 50. Останавливайте обход по отсутствию meta.next или при достижении meta.total, поскольку запрос за последней страницей элементов возвращает первую страницу.

BC-1028-9: typeIds рабочего места больше не принимает значения без своего типа

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

Было

POST /v1/automated-solutions и PATCH /v1/automated-solutions/:id с typeIds, где есть значение без соответствующего типа смарт-процесса (в том числе entityTypeId вместо id), отвечали 200/201: Битрикс24 молча отбрасывал такое значение. На PATCH, где набор заменяется целиком, это отвязывало от рабочего места все типы, которых не было в запросе.

Стало

Тот же запрос отвечает 400 UNKNOWN_TYPE_ID до обращения к Битрикс24 и ничего не меняет. В error.details.unknown перечислены неизвестные значения, в error.details.knownIds — доступные идентификаторы типов; если передан entityTypeId, текст ошибки называет id соответствующего типа. Значение, переданное объектом вместо массива или числа, отвечает 400 INVALID_PARAMS. Пустой массив [] по-прежнему отвязывает все типы и ошибкой не считается. Проверка опирается на справочник типов портала: если Битрикс24 не отдаёт его или отдаёт неполным, запись выполняется без проверки — в этом случае сверяйте typeIds в ответе.

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

Сверять значения typeIds с полем id типов из GET /v1/smart-processes, а не с entityTypeId. Ответ UNKNOWN_TYPE_ID содержит список доступных идентификаторов, поэтому для исправления не нужно отдельное чтение.

NEW-1028-10: Трейсы сквозной аналитики через REST v3

Добавлены чтение списка и отдельного трейса, создание с явным источником и полное удаление через REST v3. Маршруты находятся за флагом и включатся вместе с обновлением Битрикс24. До включения прежние создание с trace и удаление продолжают работать.