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

[← Журнал изменений](/docs/changelog) · [Октябрь 2026](/docs/changelog/2026-10)

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

**Было**

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

**Стало**

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

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

**Было**

[POST /v1/deals/aggregate](/docs/entities/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](/docs/management-keys), [POST /v1/cowork/applications](/docs/cowork/applications-create) и [POST /v1/cowork/applications/:id/key](/docs/cowork/applications-key) отвечали `400 PORTAL_NOT_LINKED`, хотя модуль Вайбкод на аккаунте мог выпустить ключ сам.

**Стало**

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

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

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

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

**Было**

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

**Стало**

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

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

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

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

**Было**

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

**Стало**

`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](/docs/posts/comments/read) возвращал `attach: []` у каждого комментария, даже когда к нему прикреплены файлы. Файлы приходили в `data.files`, но связать их с комментарием по ответу было нельзя.

**Стало**

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

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

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

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

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

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

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

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

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

**Было**

[POST /v1/automated-solutions](/docs/entities/automated-solutions/create) и [PATCH /v1/automated-solutions/:id](/docs/entities/automated-solutions/update) с `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](/docs/entities/smart-processes/list), а не с `entityTypeId`. Ответ `UNKNOWN_TYPE_ID` содержит список доступных идентификаторов, поэтому для исправления не нужно отдельное чтение.

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

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