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

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

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

BC-1027-1: Запись списков отклоняет пустые поля и уточняет обязательные ключи схем

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

Было

Следующие операции передавали fields: {} в Битрикс24:

При обновлении элемента такой запрос мог очистить все его поля. Схемы OpenAPI для операций над полями списка допускали запросы без ключей, обязательных для Битрикс24.

Стало

Эти операции с fields: {} возвращают 400 MISSING_REQUIRED_FIELDS до обращения к Битрикс24. Это требование действует и для обновления списка с messages или rights. Непустые объекты передаются как прежде, включая явно пустые значения полей.

В OpenAPI создание поля списка теперь требует непустые строки NAME, TYPE и CODE внутри fields, а обновление поля списка — непустую строку TYPE. Сгенерированные по новой схеме клиенты и валидаторы могут отклонять неполные непустые объекты ещё до отправки запроса. Эти ключи уже требовались Битрикс24.

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

Передавайте хотя бы одно поле, которое нужно записать. Если обновление не требуется, не отправляйте запрос. Для обновления элемента передавайте полный желаемый набор полей: это по-прежнему полная перезапись, и пропущенные поля очищаются. Явные пустые значения, допустимые для поля, сохраняют прежнее поведение, например {"NAME":""}.

При создании поля передавайте, например, {"fields":{"NAME":"Priority","TYPE":"S","CODE":"PRIORITY"}}. При обновлении поля всегда передавайте его текущий TYPE, например {"fields":{"TYPE":"S"}}: изменить тип существующего поля нельзя. Проверьте эти ключи и непустые значения при регенерации клиентов по OpenAPI.

NEW-1027-2: Повторная замена сервера без второй покупки

POST /v1/applications/:id/replace-server принимает необязательный заголовок Idempotency-Key при создании нового сервера. Повтор с тем же ключом API, значением заголовка и телом запроса в течение 24 часов после первого вызова не создаёт второй платный сервер. Если замена завершена и приложение остаётся на этом сервере, ответ содержит первоначальный результат, заголовок Idempotent-Replayed: true и пустой массив warnings.

Если результат предыдущего вызова неизвестен, повтор возвращает 409 IDEMPOTENCY_KEY_ALREADY_USED. Перед новой покупкой проверьте карточку приложения и серверы в кабинете. После 24 часов защита от повторной покупки может закончиться. Форма { serverId } игнорирует заголовок. Без заголовка поведение не меняется.

FIX-1027-3: Рекомендация тарифа Коворк/Код учитывает окна места

Было GET /v1/cowork/state рекомендовал следующую ступень тарифа, даже если она не увеличивала доступные месту окна.

Стало recommendation.upgrade.nextTier и tiers[].isNext указывают первый более высокий тариф, который увеличивает хотя бы одно окно и не уменьшает остальные. Учитываются партнёрские окна и действующее демо; временный буст не влияет на выбор. Если подходящего тарифа нет, рекомендация отсутствует.

BC-1027-4: HEAD на трёх маршрутах больше не запускает GET-операцию

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

Было

Автоматический HEAD мог выполнить обработчик GET на адресах скачивания вложения комментария, получения SSH-данных сервера и получения ТЗ чертежа приложения. Он получал отдельный лимит запросов и мог отвечать успешно после исчерпания лимита GET.

Стало

HEAD на этих адресах возвращает HTTP 404 без запуска обработчика. Поведение GET не меняется.

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

Не используйте HEAD для проверки этих адресов. Вызывайте GET только когда требуется содержимое: для вложения он возвращает байты файла, а для SSH-маршрута — секретные данные подключения. Не сохраняйте SSH-ответ в обычных журналах проверок.

Затронутые эндпоинты: GET /v1/tasks/:taskId/comments/:id/files/:fileId/download, GET /v1/infra/servers/:id/ssh, GET /v1/app/blueprints/:slug.

NEW-1027-5: Период исчерпанной AI-квоты в ответе

У компаний с дневными, недельными и месячными AI-лимитами ответ 402 ai_quota_exhausted содержит поле error.window (DAY, WEEK или MONTH) и время возобновления error.resetAt. Причина window_exhausted означает остановку до обновления окна, unknown_reaction — необходимость обратиться к администратору. Настроенное использование кошелька сохраняет причины wallet_empty, wallet_off и breaker.

Затронуты POST /v1/chat/completions, POST /v1/embeddings, POST /v1/images/generations и POST /v1/audio/transcriptions.

GET /v1/ai/quota также возвращает data.scheme (NEW или LEGACY). При NEW поле data.windows содержит день, неделю и месяц компании: kind, sizeVibes (null — без ограничения), usedVibes, resetAt, reaction. Старые поля и разбивки сохраняются.

NEW-1027-6: действия над сервером, который переносится в другую зону, отвечают 409 SERVER_ZONE_MOVING

Платформа может перенести сервер в другую зону доступности вместе с диском. На время переноса, обычно 10–20 минут, сервер спит и не просыпается. POST /v1/infra/servers/{id}/start, /stop, /sleep-now, /reboot, /wake и /repair над таким сервером отвечают 409 SERVER_ZONE_MOVING и ничего не меняют: статус, биллинг и машина остаются как были. error.userMessage несёт текст для человека. Повторите действие после того, как перенос закончится.

BC-1027-7: создание отдельной машины отвечает сразу, без SSH-данных

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

Было

POST /v1/infra/servers для отдельной машины, если готовая машина была доступна, ждал её и отвечал running с ip, иначе отвечал provisioning. Первый ответ всегда один раз отдавал ssh.privateKey платформы (и ssh.password, если он был), документация советовала его сохранить. Отказ облака возвращал 502 PROVIDER_ERROR. Без заголовка Idempotency-Key запись сервера удалялась, и квота не тратилась, а с ним запись оставалась со статусом error. Блокировка учётки, поставленная во время создания, возвращала 403 SERVER_WAKE_BLOCKED.

Стало

Ответ приходит сразу: status: "provisioning", ip: null. Поля ssh.password и ssh.privateKey всегда null. Отказ облака приходит позже как status: "error", причина — в provisionError. Блокировка, поставленная до заказа машины, заканчивается так же: status: "error" и причина в provisionError. Блокировка, поставленная после заказа машины, оставляет сервер в status: "sleeping" (машина остановлена) с пустым provisionError. Запись с ошибкой остаётся и занимает место в лимите серверов на пользователя, пока её не удалят.

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

Опрашивайте GET /v1/infra/servers/:id, пока статус не станет running, error или sleeping. При error прочитайте provisionError, удалите запись через DELETE и создайте сервер заново. SSH-доступ нужен только если сервер переключён в режим OPEN, а это делает человек в кабинете (PATCH /v1/infra/servers/:id/mode на OPEN для любого API-ключа отвечает 403 DIRECT_NETWORK_CHANGE_REQUIRES_HUMAN). После этого GET /v1/infra/servers/:id/ssh отдаёт данные. С одним API-ключом SSH недоступен, для работы с сервером в режиме Black Hole используйте Deploy API (exec, upload, logs).

BC-1027-8: Для публикации поста нужно явно указать получателей

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

Было

POST /v1/posts публиковал пост всем сотрудникам, если recipients был пропущен или содержал пустой массив.

Стало

Поле recipients обязательно. Пропуск или пустой массив возвращает 400 MISSING_PARAMS, неверный тип или код получателя — 400 INVALID_PARAMS. До исправления запроса пост не публикуется. Допустимы U<id>, SG<id>, D<id>, DR<id> с положительным целым ID без начальных нулей. UA разрешён только без других получателей. Не более 100 различных получателей и 1000 элементов входного массива.

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

Передавайте согласованную аудиторию в каждом запросе. Для публикации всем сотрудникам явно укажите recipients: ["UA"]. Ответ возвращает id поста и переданный массив recipients. Если результат отправки неизвестен, проверьте ленту перед повторной публикацией.