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

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

FIX-1007-1: повторное удаление сервера, пока первое ещё идёт, больше не отвечает успехом

Было

DELETE /v1/infra/servers/{id} для сервера с kind, отличным от GALAXY_APP, пришедший пока другой вызов ещё удаляет ту же машину, отвечал успехом.

Стало

Удаление такого сервера, которое выполнил этот вызов, по-прежнему отвечает HTTP 200. Вызов, который этот сервер уже не удалял, отвечает 404 NOT_FOUND, как повторный запрос к уже удалённому серверу. Для kind=GALAXY_APP коды этого маршрута не меняются. Ответ по-прежнему HTTP 200, когда удаление выполнил этот вызов.

NEW-1007-2: Правка содержимого и публикация отдельного блока страницы

Добавлены подресурсы /v1/pages/:pageId/blocks/:blockId: PATCH /nodes, /styles, /attrs, /tags, PUT /anchor, POST /files, /publication. Нужен скоуп landing; query scope выбирает контекст страницы. Неизвестный селектор или индекс и пустой набор правок дают 400. Замена классов сохраняет все классы адресации манифеста. Неприменимое значение текстового узла получает 400. Ответы записи содержат перечитанный HTML; Б24 может фильтровать текст и атрибуты. Файлы загружаются только как base64-картинки, лимит JSON 40 MiB. Публикация блока оставляет остальные изменения страницы черновиком.

NEW-1007-3: Привязки баз знаний к меню и рабочим группам

Добавлены GET /v1/sites/menu-bindings и GET /v1/sites/group-bindings с необязательными фильтрами menuCode и groupId, без пагинации. POST /v1/sites/:id/menu-bindings и DELETE /v1/sites/:id/menu-bindings/:menuCode меняют меню для всех сотрудников; нужен тип KNOWLEDGE. Двоеточие в коде меню в пути URL-кодируется. POST /v1/sites/:id/group-binding меняет тип сайта на GROUP, DELETE /v1/sites/:id/group-binding/:groupId — на KNOWLEDGE. Для страниц привязанной базы нужен scope=GROUP. Ответы записей перечитывают привязки; групповые действия также возвращают сайт с новым типом. Нужен скоуп ключа landing; READONLY запрещает запись. Нет сайта — 404 ENTITY_NOT_FOUND, неподходящий тип — 409 SITE_BINDING_TYPE_MISMATCH, отказ Б24 без причины — 422 BITRIX_ERROR.

NEW-1007-4: Карточки блока и сохранённые шаблоны

Карточки блока: POST /v1/pages/:pageId/blocks/:blockId/cards/clone, POST /v1/pages/:pageId/blocks/:blockId/cards, DELETE /v1/pages/:pageId/blocks/:blockId/cards/:index с query selector, PUT /v1/pages/:pageId/blocks/:blockId/cards. Запись возвращает перечитанные cards: словарь селекторов с массивами {index,content}. Индексы меняются после записи. Пересборка всего набора принимает selector, непустой source и values; неизвестные селекторы и индексы дают 400 до записи.

POST /v1/pages/:pageId/blocks/:blockId/favorite с {name,sections?} сохраняет шаблон в каталоге аккаунта Битрикс24, доступный всем редакторам. Возвращает {blockId,code}; preview не поддерживается. DELETE /v1/block-repository/favorites/:blockId физически удаляет шаблон текущего пользователя. Отсутствующие карточки и шаблоны дают 404. Все маршруты требуют landing, принимают query scope и запрещают запись READONLY-ключу.

BC-1007-5: общие методы жизненного цикла закрыты для серверов агента и бота

Поддержка старого формата до: 06.10.2026

Было

POST /v1/infra/servers/{id}/start, /stop и /wake могли запускать и останавливать сервер управляемого агента или бота через общий серверный API.

Стало

Для таких серверов методы отвечают 409 MANAGED_SERVER_LIFECYCLE без обращения к облаку. Управляйте агентом или ботом через его карточку в кабинете. Для обычных серверов и Galaxy App поведение методов не изменилось.

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

Не вызывайте общие методы Start/Stop/Wake для серверов управляемых агентов и ботов. Предложите пользователю управлять ими в кабинете.

FIX-1007-6: боты восстанавливаются после смены адреса портала

Было

После смены адреса портала регистрация бота могла остаться привязанной к прежнему адресу. Для восстановления требовался ручной API-вызов, а повторная регистрация с новым ID могла оставить Открытые линии и WELCOME_BOT привязанными к старому боту.

Стало

Платформа Вайбкод автоматически восстанавливает регистрацию после смены адреса. Сначала она пытается сохранить ID; если это невозможно, переносит ссылки Открытых линий на новый ID, включая WELCOME_BOT. При временном сбое восстановление продолжится автоматически. Запрос владельца со старым ID получает BOT_ID_REPLACED с актуальным error.details.botId.

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

Действий не требуется. Клиент может использовать error.details.botId, если сохранил прежний числовой ID бота.

BC-1007-7: ключ сотрудника, отмеченного уволенным, отвечает 403 OWNER_BLOCKED

Поддержка старого формата до: 21.10.2026

Было

Когда проверка сотрудников портала находила, что владелец ключа уволен в Битрикс24, ключ мог продолжать работать: вызовы V1 с ним проходили, включая ИИ, поиск, хранилище, серверы и расход кредитов портала.

Стало

Пока сотрудник отмечен уволенным, любой вызов V1 с его ключом получает 403 OWNER_BLOCKED — тот же код и текст, что у заблокированного владельца. Ключ не отзывается: как только Битрикс24 снова показывает сотрудника активным, ключ работает без перевыпуска. Отказ получают все ключи этого человека на портале: личные ключи, ключи его OAuth-приложений и ключи, которые он передал задеплоенным приложениям, — у всех пользователей портала. Агенты и боты, созданные на его ключах, перестают отвечать. Ключ устройства Cowork/Code, который простоял под отметкой больше 60 дней, после снятия отметки может понадобиться выпустить заново.

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

Если интеграция ходит ключом уволенного сотрудника, выпустите ключ от имени активного сотрудника портала и замените его в интеграции. Если отметка ошибочна, исправьте статус сотрудника в Битрикс24 — после следующей проверки ключ снова заработает. Если после восстановления сотрудника в Битрикс24 ключ так и не заработал, обратитесь в поддержку. Разбор кода — Авторизация, ключи и права.

BC-1007-8: Каталог инструментов и список баз 1С требуют доступа к 1С

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

Было

GET /v1/onec/tools и GET /v1/onec/instances отвечали 200 любому ключу со скоупом vibe:onec. Сопоставление владельца ключа с учётной записью 1С не проверялось, поэтому ключ, получивший скоуп раньше или сохранивший его после снятия доступа, продолжал читать каталог и список баз.

Стало

Оба адреса проверяют доступ владельца ключа к 1С так же, как выдача скоупа: действующее сопоставление с учётной записью 1С или назначение через подразделение. Каталог проверяет доступ к той базе, к которой обращается: доступ к другой базе не подходит. Список баз отдаётся, если доступ есть хотя бы к одной базе, а пустой список доступа не требует. Без доступа оба адреса отвечают 403 ONEC_USER_NOT_MAPPED — тот же отказ, что у POST /v1/onec/tools/{method}/call. Если состав подразделений Битрикс24 проверить не удалось, ответ 503 ONEC_DIRECTORY_UNAVAILABLE с заголовком Retry-After. Пока назначения пользователей 1С временно выключены, ответ 503 ONEC_ASSIGNMENTS_DISABLED. Для сотрудников с доступом ответы не изменились.

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

Обрабатывайте 403 ONEC_USER_NOT_MAPPED на каталоге и списке баз так же, как на постановке чтения: попросите администратора выдать сотруднику доступ к 1С в кабинете, раздел «Интеграция 1С». 503 повторяйте после паузы из Retry-After. Старое поведение не сохраняется: оно открывало каталог без доступа к 1С.

FIX-1007-9: выдача ключа на неплатном тарифе отвечает 402 со ссылкой на покупку

Было

Если Битрикс24 отказывал в выдаче ключа из-за неплатного тарифа, выдача ключа (POST /v1/keys, POST /v1/apps) завершалась общей ошибкой выдачи.

Стало

Ответ — 402, в error.details.upgradeUrl — ссылка на покупку тарифа или лицензии, в error.details.secondaryUpgradeUrl — дополнительная, если Битрикс24 их передал.

NEW-1007-10: Восстановление и окончательное удаление объектов Диска

Добавлены POST /v1/files/:id/restore, POST /v1/folders/:id/restore, POST /v1/files/:id/purge и POST /v1/folders/:id/purge со скоупом disk. Restore возвращает объект и meta.restored, meta.renamedFrom; уже живой объект возвращает restored: false. Purge безвозвратно удаляет объект, все версии и связанные вложения мимо корзины; для папки удаляется всё дерево, операция не транзакционна. Корень хранилища удалить нельзя. Обычный DELETE остаётся корзиной. Отказ удаления возвращает 422 DISK_DELETE_REFUSED, неподтверждённое восстановление — 422 DISK_RESTORE_REFUSED. Записи не повторяются автоматически; при 502 DISK_OUTCOME_UNKNOWN перечитайте объект после сетевого сбоя.

NEW-1007-11: Полнотекстовый поиск Диска и операции хранилища

Поиск по всему доступному Диску через POST /v1/files/fulltext-search: запрос по индексу, файлы и папки, фильтры области и типа файла, страницы по 50 записей до смещения 1000. Корзина исключена, индекс обновляется асинхронно, общего числа совпадений нет. POST /v1/storages/:id/folders создаёт папку в корне хранилища без поиска parentId. GET /v1/storages/types возвращает неполный справочник типов Битрикс24.

NEW-1007-12: История и содержимое версий файла на Диске

Добавлены история версий, чтение, скачивание, восстановление и загрузка новой версии существующего файла. Требуется scope disk. Версия другого файла даёт 404. Ссылки скачивания ведут на авторизованный V1-маршрут. Повторная загрузка тем же автором за примерно пять минут может перезаписать последнюю версию; восстановление создаёт новую и может вытеснить старую. Записи автоматически не повторяются; после неизвестного исхода перечитайте файл.

NEW-1007-13: публичные ссылки Диска и доступ к папке сотруднику

Добавлены POST /v1/files/:id/public-link, POST /v1/folders/:id/public-link, POST /v1/folders/:id/shares и GET /v1/folders/access-levels со скоупом disk. Публикация создаёт или возвращает секретную ссылку для любого пользователя без авторизации; корень хранилища публиковать нельзя. Ответ содержит revocableViaApi:false и meta.inTrash. Корзина приостанавливает ссылку, восстановление открывает снова, физическое удаление гасит её.

Выдача доступа принимает userId и access:read|add|edit|full, возвращает 201 и выдаёт права сразу, до «Принять». Со скоупом user, user_basic или user_brief получатель проверяется до записи; без него meta.recipientVerified:false, Б24 может принять несуществующий id. Владелец и повтор дают 409. Отзыв и смена уровня через REST отсутствуют. Справочник возвращает id/code/title, READONLY допускается только для чтения. Записи автоматически не повторяются; при неизвестном исходе сначала перечитайте состояние. Файл, папка, выдача доступа, уровни.

BC-1007-14: Стадия задачи проверяется по канбану целевой группы

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

Было

PATCH /v1/tasks/:id принимал stageId чужой группы или «Моего плана»; старые версии Битрикс24 могли ответить успехом и записать несовместимую стадию.

Стало

Такие запросы получают 400 INVALID_PARAMS до записи. При одновременной смене groupId проверяется канбан новой группы. Для «Моего плана» используйте POST /v1/tasks/:taskId/move-stage. Нулевой stageId сохраняет штатный выбор первой колонки группы.

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

Передавайте stageId из канбана целевой группы. Перенос в «Мой план» выполняйте отдельным действием move-stage.

NEW-1007-15: Управление стадиями задач и чтение плана дня

Можно создавать стадии канбана группы и «Моего плана», изменять и удалять пустые стадии, переносить задачи с порядком, читать право сортировки и план дня. Создание без позиции добавляет колонку в конец. Явная первая позиция меняет стадию группы по умолчанию, перестановка может перенести задачи без записи в истории. Чтение плана дня сохраняет обрезку до 30 задач, как виджет Битрикс24. Фильтр stagesId показывает позицию в «Моём плане» отдельно от stageId задачи.

NEW-1007-16: Управление пользовательскими полями задач

Добавлены GET/POST /v1/userfields/tasks, GET /v1/userfields/tasks/types и GET/PATCH/DELETE /v1/userfields/tasks/:id со скоупом task. Доступны схема, варианты списков с xmlId, создание и изменение подписей. Поле общее для всех задач портала; удаление необратимо стирает значения во всех задачах. Системные поля защищены от записи. PATCH отвергает неизменяемые свойства, пустые изменения и варианты списка без значения, сохраняя прежний xmlId, если он не передан.

BC-1007-17: Остаток товара на складе и защита базовой валюты

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

Было

PATCH /v1/currencies/:id принимал base и подтверждал обновление, хотя базовая валюта не менялась.

Стало

Поле base и его псевдоним BASE только для чтения: обновление возвращает 400 READONLY_FIELD. Сменить базовую валюту можно в интерфейсе Битрикс24.

Добавлено чтение GET /v1/warehouses/:id/stock/:recordId. Строка другого склада, отсутствующая или недоступная строка возвращает 404 ENTITY_NOT_FOUND. Остаток и резерв могут быть null, резерв может превышать остаток.

GET /v1/warehouses/:id/stock принимает необязательный productId для выбора товара на складе. Некорректный идентификатор возвращает 400 INVALID_PARAMS. Другие фильтры по-прежнему не поддерживаются.

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

Уберите base из тела обновления валюты. Для выбора товара передавайте productId, для чтения строки используйте её recordId из списка остатков.