Изменения API: 27 сентября 2026

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

FIX-0927-3: операции с бизнес-процессами на портале без модуля отвечают 409 вместо 404

Было

На портале, где бизнес-процессы не входят в тариф или выключены в настройках, код 409 BIZPROC_MODULE_NOT_ENABLED отдавал только список запущенных процессов — GET /v1/workflows. Четыре остальные операции раздела на том же состоянии портала отвечали 404 ENTITY_NOT_FOUND: POST /v1/workflows/start, DELETE /v1/workflows/:id, POST /v1/workflows/activity-log и POST /v1/workflows/event. Такой ответ выглядел как неверный идентификатор шаблона, документа или процесса, хотя идентификаторы были в порядке.

Стало

Все пять операций раздела на этом состоянии портала отвечают одинаково: 409 BIZPROC_MODULE_NOT_ENABLED. Сообщение называет вызванный метод Битрикс24, обе возможные причины и действие: попросить администратора портала включить бизнес-процессы. Остальные ошибки этих операций не изменились.

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

Действий не требуется: отказ как был 4xx, так и остался, а прежний 404 ENTITY_NOT_FOUND для этого состояния документацией не обещался. Повторять запрос с другими идентификаторами бесполезно, пока бизнес-процессы на портале недоступны. У остановки процесса 404 ENTITY_NOT_FOUND по-прежнему означает, что экземпляр процесса не найден, а 409 BIZPROC_MODULE_NOT_ENABLED — что модуль недоступен и процесс не остановлен. Интеграция, которая считала 404 признаком уже завершённого процесса, на таком портале теперь увидит 409, и процесс при этом не остановлен.

NEW-0927-5: Действия над чек-листом и прикрепление файла к задаче

Добавлены десять именованных маршрутов /v1/tasks/:taskId/checklist/... и /v1/tasks/:taskId/files/attach: сохранение дерева, участники, перемещение, массовое завершение и вложения чек-листа, а также прикрепление файла Диска к задаче. Ответ каждого маршрута содержит результат метода Bitrix24 в data.