#Журнал изменений API Вайбкод
История изменений API Вайбкод: новые возможности, исправления и изменения с потерей обратной совместимости. Записи расположены от новых к старым.
#Префиксы записей
- NEW — новая возможность: новый эндпоинт, новое необязательное поле или параметр, новый код ошибки в новом сценарии. Прежние запросы клиентов продолжают работать.
- FIX — исправление поведения. Ответ меняется на корректный, действий со стороны клиента не требуется.
- BC — изменение с потерей обратной совместимости. Требует действий со стороны клиента. Старый формат поддерживается указанный срок, затем прекращается.
Формат кода записи: {ТИП}-{ММДД}-{N}, где ММДД — дата публикации, N — сквозной номер в рамках даты.
Часть записей NEW помечена в процессе раскатки: метод вышел в конкретном обновлении Битрикс24 и доступен не на всех порталах. Пока обновление не приехало на портал, вызов возвращает 422 METHOD_NOT_YET_AVAILABLE с целевой версией — это признак раскатки, а не ошибка интеграции.
#2026-06-23
#FIX-0623-1: список действий бизнес-процессов
Было
GET /v1/bizproc-activities возвращал каждый код действия как объект с числовыми ключами по символам — например, {"0":"D","1":"i", …} вместо строки "DiskRead". Проверка Array.includes(code) не работала.
Стало
Эндпоинт возвращает коды действий массивом строк, как и задокументировано.
#FIX-0623-2: ключи ответа поиска дубликатов в camelCase
Было
POST /v1/duplicates/find возвращал ключи объекта data в верхнем регистре (LEAD, CONTACT, COMPANY), в отличие от остального API в camelCase.
Стало
Ключи приходят в camelCase (lead, contact, company); значения (массивы идентификаторов) не меняются.
#FIX-0623-3: поле files эпика Scrum массивом идентификаторов
Было
GET /v1/scrum/epics/:id отдавал поле files сырым UF-объектом Битрикс24 (с VALUE_RAW, USER_TYPE_ID и прочими внутренними метаданными).
Стало
files — массив идентификаторов вложений ([417]) или пустой массив, в едином стиле с остальным API.
#2026-06-19
#FIX-0619-1: создание документа
Было
POST /v1/documents возвращал 422 и не создавал документ.
Стало
Эндпоинт создаёт документ из шаблона и возвращает запись.
#FIX-0619-2: авто-пагинация складов
Было
GET /v1/warehouses и остатки по складу возвращали только первую страницу при limit > 50.
Стало
Авто-пагинация собирает все записи в один ответ.
Затронутые эндпоинты: GET /v1/warehouses, GET /v1/warehouses/:id/stock
#2026-06-18
#NEW-0618-1: группировка в агрегации сделок
POST /v1/deals/aggregate принимает groupBy: "stageSemanticId" — разбивка по семантике стадии (в работе, успех, провал) для аналитики воронки.
#NEW-0618-2: пагинация и фильтр истории стадий
GET /v1/stage-history поддерживает пагинацию (meta.total, meta.hasMore) и фильтр по типу сущности entityTypeId.
#FIX-0618-3: учёт времени задачи не переназначает автора
Было
PATCH /v1/tasks/:taskId/time/:id принимал поле userId, но Битрикс24 не переназначает автора записи — значение молча игнорировалось.
Стало
Поле userId отклоняется с 400 — автора записи учёта времени сменить нельзя.
Влияние на интеграторов
Не передавайте userId при обновлении записи учёта времени.
#FIX-0618-4: таймзона события календаря
Было
PATCH /v1/calendar-events/:id мог сохранять время в таймзоне пользователя Битрикс24, а не самого события.
Стало
Таймзона события сохраняется при обновлении.
#2026-06-17
#NEW-0617-1: База знаний 2.0 (note.*)
Коллекции, документы и вложения базы знаний. Скоуп note.
В процессе раскатки — методы выходят в обновлении Битрикс24 note 26.100.0 и доступны не на всех порталах. Пока обновление не приехало на портал, метод возвращает 422 METHOD_NOT_YET_AVAILABLE с целевой версией в ответе — это признак раскатки, а не ошибка интеграции.
Затронутые эндпоинты: /v1/note/collections, /v1/note/documents, /v1/note/documents/:documentId/files
#2026-06-16
#NEW-0616-1: AI follow-up завершённых звонков
AI follow-up по завершённым звонкам. Скоуп call.
В процессе раскатки — методы выходят в обновлении Битрикс24 call 26.600.0 и доступны не на всех порталах. Пока обновление не приехало на портал, метод возвращает 422 METHOD_NOT_YET_AVAILABLE с целевой версией в ответе — это признак раскатки, а не ошибка интеграции.
Затронутые эндпоинты: POST /v1/calls/followups/list, GET /v1/calls/followups/:callId
#FIX-0616-2: формат ответа транскрипции
Было
POST /v1/audio/transcriptions всегда возвращал JSON-объект, даже при response_format=text, srt или vtt.
Стало
text, srt, vtt отдают сырое тело в формате text/plain, SubRip или WebVTT. json и verbose_json отдают JSON-объект.
#2026-06-12
#BC-0612-1: поле payed заказа только для чтения
Поддержка старого формата до: не предусмотрена, поле стало read-only
Было
payed принимался в теле создания и обновления заказа.
Стало
payed доступно только для чтения — при записи отклоняется.
Что делать интеграторам
Уберите payed из тела POST /v1/orders и PATCH /v1/orders/:id.
Затронутые эндпоинты: POST /v1/orders, PATCH /v1/orders/:id
#2026-06-11
#NEW-0611-1: Scrum API
Эпики, привязка задач к эпикам и чтение чата задачи. Скоуп tasks.
Затронутые эндпоинты: /v1/scrum/epics, /v1/scrum/epics/:id, /v1/scrum/tasks/:taskId — раздел Scrum
#NEW-0611-2: оценка звонка при завершении
POST /v1/calls/:callId/finish принимает оценку завершённого звонка и передаёт её в Битрикс24.