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

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

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

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 принимал в contentType любую непустую строку и сохранял её как есть. Для PUBLIC-объектов отклонялись только типы HTML, JavaScript и SVG. Значение со списком через запятую, например text/plain,text/html, а также XML, XHTML и unknown/unknown проходили, и браузер мог открыть такой публичный файл как страницу.

Стало

contentType и тип содержимого части file в POST /v1/storage/objects/upload принимают ровно один тип 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 вместе с HEAD по тому же пути. Байты и сохранённый тип при этом не меняются: уже загруженным объектам тип автоматически не исправляется.

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

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

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

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

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

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

Новый адрес POST /v1/solution-events: решение ключом своего приложения сообщает порталу Битрикс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 без offset, а также с offset, равным сохранённому курсору, читает очередь с начала. Такое чтение ничего не удаляет. Подтверждается только nextOffset событий, которые этот же запрос вернул. После сброса нумерации nextOffset в ответе может стать меньше прежнего.

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

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