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

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

### FIX-1105-1: Маршруты Definition of Done и метрик спринта в Scrum снова вызывают Битрикс24

**Было**

`GET /v1/scrum/groups/{groupId}/dod/settings`, `GET /v1/scrum/groups/{groupId}/tasks/{taskId}/dod/necessary`, `GET /v1/scrum/groups/{groupId}/burn-down`, `GET /v1/scrum/groups/{groupId}/team-speed`, `POST /v1/scrum/groups/{groupId}/dod/types/{typeId}/settings` и `POST /v1/scrum/tasks/{taskId}/dod/{typeId}` отвечали `422 BITRIX_ERROR` с `b24Code: ERROR_EMPTY_ENTITY_ID` и сообщением «Не указан код сущности», хотя Битрикс24 на те же параметры отвечает успехом.

**Стало**

Маршруты возвращают фактический ответ Битрикс24: [Definition of Done в Scrum](/docs/scrum/dod), [Метрики спринта](/docs/scrum/metrics).

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

Ничего менять не нужно: адреса, параметры и форма ответа прежние.

### FIX-1105-2: часовые пояса событий календаря доступны в описании входных полей

**Было**

Поля `timezoneFrom` и `timezoneTo` принимались при создании и изменении событий календаря, но отсутствовали во входных схемах MCP discover.

**Стало**

MCP discover публикует оба поля во входных схемах создания и изменения `/v1/calendar-events`. Они предназначены только для записи; смещение часового пояса в ответе по-прежнему указано в `from` и `to`.

### BC-1105-3: изменение записи не уходит в Битрикс24 повторно, а неудачное перечитывание не выдаётся за отказ

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

**Было**

`PATCH` записи сущности — например, [PATCH /v1/deals/{id}](/docs/entities/deals/update), [PATCH /v1/contacts/{id}](/docs/entities/contacts/update), [PATCH /v1/leads/{id}](/docs/entities/leads/update) или [PATCH /v1/companies/{id}](/docs/entities/companies/update) — при временной недоступности портала (ответ `503` без кода ошибки) или при перенаправлении повторялся на стороне Вайбкод, и одна запись могла дойти до портала несколько раз: у телефона, почты или сайта это дописывало строку повторно. Если изменение было принято, а перечитать запись после него не удалось, ответ приходил ошибкой — например, `429 RATE_LIMITED`, — хотя запись уже изменилась.

**Стало**

Запись уходит в Битрикс24 повторно только после отказа, который портал даёт до исполнения метода, — превышения лимита запросов `QUERY_LIMIT_EXCEEDED`; так было и раньше. Временная недоступность портала и перенаправление отвечают `502 BITRIX_UNAVAILABLE`, без повтора. Если изменение принято, а перечитать запись не удалось, ответ — `200`: в `data` только `id`, в `meta.warnings` — предупреждение `REREAD_FAILED`.

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

После `429` на `PATCH` подождите столько секунд, сколько указано в `Retry-After`, и повторите запрос: запись не применялась. После `502` и `503` сначала перечитайте запись: изменение могло примениться. Получив `REREAD_FAILED`, тоже перечитайте запись, а не повторяйте `PATCH`.

### BC-1105-4: Удаление приложения ожидает защитную копию базы данных

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

**Было**

[DELETE /v1/infra/servers/{id}](/docs/infra/servers/delete) для приложения `GALAXY_APP` мог вернуть HTTP 200 и удалить приложение без защитной копии базы данных, если подготовка копии не удалась.

**Стало**

Если подготовка копии завершается кодом `APP_DB_TOOL_UNAVAILABLE`, запрос возвращает HTTP 503. Приложение остаётся доступным для повторного удаления. Прежнее удаление без копии при таком отказе прекращается сразу, поскольку оно могло привести к потере данных.

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

Считайте HTTP 503 отказом от удаления. Проверьте готовность базы данных приложения, устраните причину отказа и повторите DELETE с тем же `id`. Не считайте приложение удалённым до успешного ответа.

### NEW-1105-5: группировка агрегатов CRM по валюте

[POST /v1/deals/aggregate](/docs/entities/deals/aggregate), [POST /v1/leads/aggregate](/docs/entities/leads/aggregate), [POST /v1/quotes/aggregate](/docs/entities/quotes/aggregate), [POST /v1/invoices/aggregate](/docs/entities/invoices/aggregate) и [POST /v1/companies/aggregate](/docs/entities/companies/aggregate) принимают в `groupBy` поле валюты: `currency` у сделок и предложений, `currencyId` у лидов, счетов и компаний. Это то имя, под которым валюта приходит в ответе списка. Ответ даёт отдельную группу со своими `count` и суммами на каждую валюту. Раньше такой `groupBy` отклонялся с `400 INVALID_PARAMS`, и при записях в нескольких валютах `sum` по сумме записи складывал их в одно число без пересчёта. Устаревший `GET /v1/{entity}/aggregate` принимает поле валюты в `groupBy` так же.

Заодно исправлены `sum`, `avg`, `min` и `max` по `amount` в `POST /v1/quotes/aggregate`: они возвращали `0` вместо значения по суммам предложений.

### NEW-1105-6: изменение и удаление одной записи телефона, почты или сайта у лида и компании

[PATCH /v1/leads/{id}](/docs/entities/leads/update) и [PATCH /v1/companies/{id}](/docs/entities/companies/update) принимают `fm` объектом. Ключ — `id` записи из `fm` в ответе `GET`: непустое `value` меняет запись, пустое `value` удаляет её. Ключи `n0`, `n1`, … добавляют записи. В записи допустимы только `typeId`, `valueType` и `value`; `typeId` — `PHONE` или `EMAIL`, у компании также `WEB`; при изменении записи `valueType` обязателен. Перед записью Вайбкод читает карточку: `id`, которого нет у этой карточки с тем же `typeId`, — `409 MULTIFIELD_ROW_NOT_FOUND`, карточку не удалось прочитать — `MULTIFIELD_PRECHECK_FAILED` (`404`, `429` с `Retry-After` или `502`); в обоих случаях ничего не записывается. После записи карточка перечитывается и сверяется с запросом: если изменение не видно — `422 MULTIFIELD_NOT_APPLIED`, перечитанная карточка в `data`; если видно, но пропала или изменилась запись, которой не было в запросе, — `200` с предупреждением `MULTIFIELD_OTHER_ROWS_CHANGED`; если сверить не удалось — `200` с предупреждением `MULTIFIELD_UNVERIFIED`. `fm` массивом, `phone`, `email` и `web` по-прежнему только добавляют записи; контакты, пакетные вызовы, импорт и создание принимают `fm` только массивом, как раньше.

### BC-1105-7: у компаний больше нет полей sourceId и sourceDescription

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

**Было**

Схема полей компаний ([GET /v1/companies/fields](/docs/entities/companies/fields)) объявляла `sourceId` и `sourceDescription`, хотя у компании Битрикс24 таких полей нет. Значение в [PATCH /v1/companies/{id}](/docs/entities/companies/update) и [POST /v1/companies](/docs/entities/companies/create) отвечало успехом и не сохранялось, `sourceId` был в списке полей для `groupBy` агрегации, а `select` и `filter` по ним принимались.

**Стало**

Поля не публикуются в схеме и не принимаются в группировке. Запись с ними по-прежнему отвечает успехом и добавляет предупреждение `UNRECOGNIZED_WRITE_FIELD` в `meta.warnings`. Явный `select` по ним — `400 UNKNOWN_SELECT_FIELD`, `filter` — `400 UNKNOWN_FILTER_FIELD`, группировка — `400 INVALID_AGGREGATION_FIELD`.

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

Уберите `sourceId` и `sourceDescription` из запросов к компаниям: они не записывались и не возвращались. Источник есть у лидов, контактов и сделок.

### FIX-1105-8: текст шаблона приложения следует оформлению по умолчанию Bitrix24

**Было**

[GET /v1/app/blueprints/:slug](/docs/app-blueprints) всегда отдавал в тексте шаблона абзац с указанием прочитать `/v1/me` и взять оформление из `data.uiDesign`.

**Стало**

Абзац есть, когда оформление по умолчанию Bitrix24 включено для аккаунта. Пока эта функция выключена, текст шаблона отдаётся без абзаца. Остальные разделы шаблона не меняются.

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

Менять ничего не нужно. Агент получает тот же текст шаблона, различается только наличие абзаца про оформление.

### FIX-1105-9: файлы с ключом длиннее 100 символов читаются и удаляются по ключу

**Было**

[GET /v1/storage/objects/{key}](/docs/storage/objects/get), [HEAD /v1/storage/objects/{key}](/docs/storage/objects/head) и [DELETE /v1/storage/objects/{key}](/docs/storage/objects/delete) отвечали `404 ROUTE_NOT_FOUND` на ключ длиннее 100 символов, хотя загрузка такой ключ принимала, а [список объектов](/docs/storage/objects/list) его показывал.

**Стало**

Эти методы принимают любой ключ, который принимает загрузка. GET отвечает перенаправлением на файл, HEAD отдаёт метаданные, DELETE удаляет файл.

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

Ничего менять не нужно. Файлы с длинными ключами, которые уже лежат в хранилище, доступны по прежнему адресу.
