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

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

← Журнал изменений · Ноябрь 2026

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, Метрики спринта.

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

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

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

Было

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

Стало

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

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

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

Было

PATCH записи сущности — например, PATCH /v1/deals/{id}, PATCH /v1/contacts/{id}, PATCH /v1/leads/{id} или PATCH /v1/companies/{id} — при временной недоступности портала (ответ 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} для приложения GALAXY_APP мог вернуть HTTP 200 и удалить приложение без защитной копии базы данных, если подготовка копии не удалась.

Стало

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

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

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

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

POST /v1/deals/aggregate, POST /v1/leads/aggregate, POST /v1/quotes/aggregate, POST /v1/invoices/aggregate и POST /v1/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} и PATCH /v1/companies/{id} принимают 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) объявляла sourceId и sourceDescription, хотя у компании Битрикс24 таких полей нет. Значение в PATCH /v1/companies/{id} и POST /v1/companies отвечало успехом и не сохранялось, 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 всегда отдавал в тексте шаблона абзац с указанием прочитать /v1/me и взять оформление из data.uiDesign.

Стало

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

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

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

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

Было

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

Стало

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

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

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