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

[← Журнал изменений](/docs/changelog) · [Октябрь 2026](/docs/changelog/2026-10)

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

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

**Было**

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

- [POST /v1/lists](/docs/lists/lists/create)
- [PATCH /v1/lists/:iblockId](/docs/lists/lists/update)
- [PATCH /v1/lists/:iblockId/fields/:fieldId](/docs/lists/fields/update)
- [POST /v1/lists/:iblockId/sections](/docs/lists/sections/create)
- [PATCH /v1/lists/:iblockId/sections/:sectionId](/docs/lists/sections/update)
- [POST /v1/lists/:iblockId/elements](/docs/lists/elements/create)
- [PATCH /v1/lists/:iblockId/elements/:elementId](/docs/lists/elements/update)

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

**Стало**

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

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

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

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

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

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

[POST /v1/applications/:id/replace-server](/docs/applications/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](/docs/entities/task-comments/file-download), [GET /v1/infra/servers/:id/ssh](/docs/infra/access/ssh), [GET /v1/app/blueprints/:slug](/docs/app-blueprints).

### 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](/docs/feed/posts/create) публиковал пост всем сотрудникам, если `recipients` был пропущен или содержал пустой массив.

**Стало**

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

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

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