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

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

### FIX-1024-1: действия над создаваемым сервером отвечают 409 SERVER_CREATING

**Было**

`POST /v1/infra/servers/{id}/start` и `/wake` над сервером, который ещё создаётся, могли ответить `422 VM_MISSING` и перевести сервер в ошибку посреди создания. Остальные действия над таким сервером меняли его статус, пока создание шло.

`POST /v1/infra/servers` с размещением в галактике, пока хост приложения ещё создавался, запускал второй хост.

`DELETE /v1/infra/servers/{id}` над сервером, к которому ещё не привязана виртуальная машина, сообщал в поле `cloudDelete` значение `not-applicable`, хотя машина могла появиться позже.

Если аккаунт ставили на удержание (баланс, подписка), пока сервер создавался, платформа всё равно покупала под него платную машину.

**Стало**

`POST /v1/infra/servers/{id}/start`, `/stop`, `/sleep-now`, `/reboot`, `/wake` и `/repair` над сервером, который ещё создаётся, отвечают `409 SERVER_CREATING` и ничего не меняют: статус, биллинг и машина остаются как были. `error.userMessage` несёт текст для человека.

`POST /v1/infra/servers` с размещением в галактике, пока хост приложения ещё создаётся, отвечает `503 GALAXY_HOST_CREATING` с заголовком `Retry-After` и ничего не создаёт — второй хост не запускается.

`DELETE /v1/infra/servers/{id}` над сервером, который ещё создаётся и к которому ещё не привязана виртуальная машина, отвечает `cloudDelete: "deferred"`: запрос в облако не отправлялся, машину, если она появится, удалит платформа. Если машина уже привязана, ответ несёт обычный исход облачного удаления (`confirmed`, `already-gone`, `failed`).

`POST /v1/infra/servers` отвечает `403 SERVER_WAKE_BLOCKED`, если аккаунт поставили на удержание, пока сервер создавался: платная машина не покупается, запись сервера остаётся в `ERROR` с причиной удержания в `provisionErrorCode`.

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

Действие над создаваемым сервером повторяйте после того, как `GET /v1/infra/servers/{id}` покажет конец создания. На `503 GALAXY_HOST_CREATING` повторите запрос через число секунд из `Retry-After`. Значение `deferred` в `cloudDelete` читайте как «машину удалит платформа». На `403 SERVER_WAKE_BLOCKED` снимите удержание и создайте сервер заново.

### NEW-1024-2: Сущностные операции Битрикс24 с ключом компании

Ключ компании поддерживает сущностные операции Битрикс24, включая `/v1/users`, `/v1/departments` и `/v1/tasks`, по текущему согласию. Поддерживаемые сущностью чтение, запись, поиск, поля, агрегация, импорт и пакетные операции отмечены `x-company-access: true` в OpenAPI. Доступны `include` и пользовательские поля. Без нужного права ответ — `403 SCOPE_MISSING`; для новых прав выполните `RECONNECT` с обновлённым согласием.

OAuth-only сущности и отдельные кастомные маршруты остаются закрытыми с `403 CONNECT_COMPANY_ROUTE_FORBIDDEN`. Оконный поиск недоступен: используйте `autoWindow: false` для обычного поиска. Публичная выдача ключей компании пока закрыта; доступность AI и хранилища проверяется отдельно.

### NEW-1024-3: Уведомления и чтение рабочего времени с ключом компании

Ключ компании поддерживает отправку уведомлений через `POST /v1/notifications`, чтение уведомлений и настроек, а также чтение рабочего времени, записей и отчётов через `/v1/workday/*` в пределах согласия текущего админа Битрикс24. Входящие уведомления и workday status/settings без `userId` относятся к этому админу. Неявное чтение настроек уведомлений требует также `user`; records требует один из `user_brief`, `user_basic`, `user`; time-control/users требует `department`. Отсутствующее согласие возвращает 403 `SCOPE_MISSING`. Остальные операции этих разделов остаются закрыты ключу компании; точный перечень доступных чтений приведён в документации подключения компании.

Маскирование секретных адресов вебхука в ответах `/v1/notifications` распространено на все ключи, включая личные: строки с такими адресами заменяются целиком на `[REDACTED]`.

### BC-1024-4: хранилище строже проверяет тип содержимого файла

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

**Было**

[POST /v1/storage/objects/multipart/create](/docs/storage/upload/multipart-create) принимал в `contentType` любую непустую строку и сохранял её как есть. Для `PUBLIC`-объектов отклонялись только типы HTML, JavaScript и SVG. Значение со списком через запятую, например `text/plain,text/html`, а также XML, XHTML и `unknown/unknown` проходили, и браузер мог открыть такой публичный файл как страницу.

**Стало**

`contentType` и тип содержимого части `file` в [POST /v1/storage/objects/upload](/docs/storage/upload/direct) принимают ровно один тип `type/subtype` с необязательными параметрами `;name=value`, без запятой в любом месте значения — включая параметр в кавычках, например `name="report,2026.pdf"`, — и длиной не больше 255 символов. Другое значение возвращает `400 STORAGE_INVALID_CONTENT_TYPE`. Тип сохраняется в каноническом виде: строчными буквами, из параметров остаётся только `charset`. Для `PUBLIC`-объектов обе загрузки возвращают `415 STORAGE_FORBIDDEN_CONTENT_TYPE` также для любого XML (`*/xml`, `*+xml`), XSL, `multipart/*`, `message/*`, `unknown/unknown`, `application/unknown` и `*/*`.

Та же проверка применяется на чтении к уже загруженным `PUBLIC`-объектам, и закрывает она больше, чем перечисленный список: раньше в `contentType` сохранялась любая непустая строка, поэтому `404 STORAGE_OBJECT_NOT_FOUND` получает и публичный объект с безопасным, но неразбираемым типом — с запятой в значении (в том числе внутри кавычек) или длиннее 255 символов. Этот `404` отдают и публичная ссылка, и [GET /v1/storage/objects/:key](/docs/storage/objects/get) вместе с `HEAD` по тому же пути. Байты и сохранённый тип при этом не меняются: уже загруженным объектам тип автоматически не исправляется.

Начатая до изменения сессия multipart с таким типом не завершается: [POST /v1/storage/objects/multipart/complete](/docs/storage/upload/multipart-complete) возвращает `415 STORAGE_FORBIDDEN_CONTENT_TYPE`. Пока такая сессия открыта на замену публичного объекта, сам объект тоже отдаётся как `404`, хотя его собственный тип допустим.

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

Передавайте в `contentType` и в типе части `file` один тип без запятых — в том числе внутри параметра в кавычках — и не длиннее 255 символов. Файлы XML и другие перечисленные типы загружайте как `PRIVATE` и отдавайте через свой сервер.

Проверьте уже загруженные `PUBLIC`-объекты: сохранённый тип виден в [GET /v1/storage/objects](/docs/storage/objects/list). Если тип запрещён или не разбирается как один тип, такой объект уже не читается ни по публичной ссылке, ни по ключу. Перезалейте файл под тем же ключом с допустимым типом — прежняя ссылка снова начнёт его отдавать, — либо загрузите файл под новым ключом как `PRIVATE` и отдавайте через свой сервер. Видимость при замене по тому же ключу не меняется, поэтому перевод в `PRIVATE` — это именно новая загрузка.

Открытую до изменения сессию multipart с таким типом прервите через [POST /v1/storage/objects/multipart/abort](/docs/storage/upload/multipart-abort) и начните загрузку заново с допустимым типом: заменяемый публичный объект сразу после отмены снова доступен по прежней ссылке, если его собственный тип допустим.

### NEW-1024-5: событие решения в портал: POST /v1/solution-events

Новый адрес [POST /v1/solution-events](/docs/applications/solution-event): решение ключом своего приложения сообщает порталу Битрикс24 о
событии, и на портале запускаются бизнес-процессы с триггером «Событие решения Вайбкод» от имени
владельца карточки решения. Ответ синхронный: `accepted`, `duplicate` или ошибка с кодом и, где повтор
поможет, `Retry-After`. Пока функция не включена для портала, адрес отвечает
`409 SOLUTION_EVENTS_NOT_ENABLED`.

### FIX-1024-6: Завершённый ответ команды больше не опережает освобождение сервера

**Было**

`POST /v1/infra/servers/:id/exec?stream=false` мог завершить JSON-ответ HTTP 200 до освобождения сервера, поэтому следующий последовательный запрос получал `409 EXEC_BUSY`. Тот же порядок затрагивал ответы exec приложения Galaxy, приёма длительного exec, JSON-выкладки и отказа смены закреплённого порта через `PATCH /v1/infra/servers/:id/port`.

**Стало**

Эти ответы завершаются после освобождения сервера от соответствующего запроса. Для синхронного exec ответ остаётся HTTP 200; коды отказов смены порта остаются 409/502. Приём длительного exec по-прежнему возвращает HTTP 202 и не ждёт окончания команды: её канал остаётся занят до завершения задачи. Реально выполняющаяся другая операция по-прежнему может вызвать `409 EXEC_BUSY`.

### FIX-1024-7: опрос событий бота не теряет события после сброса нумерации в Битрикс24

**Было**

Опрос без `offset` отправлял в Битрикс24 сохранённый курсор. Битрикс24 перед чтением удаляет все события бота с номером меньше переданного. Когда Битрикс24 начинал нумерацию событий заново, новые события получали номера меньше курсора и удалялись раньше, чем бот их получал.

**Стало**

[GET /v1/bots/{botId}/events](/docs/bots/events/polling) без `offset`, а также с `offset`, равным сохранённому курсору, читает очередь с начала. Такое чтение ничего не удаляет. Подтверждается только `nextOffset` событий, которые этот же запрос вернул. После сброса нумерации `nextOffset` в ответе может стать меньше прежнего.

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

Менять запросы опроса событий бота не нужно. Если подтверждение не дошло до Битрикс24, те же события придут повторно, поэтому обработка должна быть идемпотентной. Удалённые ранее события не восстанавливаются.
