Для AI-агентов: markdown этой страницы — /docs-content/changelog/2026-11-13.md индекс документации — /llms.txt
Изменения API: 13 ноября 2026
← Журнал изменений · Ноябрь 2026
BC-1113-1: чужой id варианта перечисления отклоняется до записи поля
Поддержка старого формата до: не предусмотрена
Было
POST /v1/items/{entityTypeId}/userfields с положительным id варианта, который принадлежит другому полю, отвечал 201, а созданное поле приходило без вариантов. PATCH /v1/userfields/{entity}/{id} с таким id в list отвечал 200, а перечисление оставалось прежним. Вариант не записывался, хотя ответ говорил об успехе.
Стало
Оба запроса отклоняются до записи: 400 INVALID_ENUM, ничего не записывается. На изменении поля текущие варианты читаются заранее, и id сверяется с ними. Если текущие варианты прочитать не удалось, запрос не отклоняется: поле обновляется, а передачу вариантов проверяет Битрикс24. Варианты без id и варианты с id этого же поля работают как раньше: на создании поле получает новые варианты, на изменении остаются переданные.
Что делать интеграторам
На создании поля передавайте варианты без id. На изменении передавайте id из ответа GET /v1/userfields/{entity}/{id}, а новый вариант добавляйте без id.
NEW-1113-2: адрес настройки входа в /v1/me и причина недоступности входа через Битрикс24
Ответ GET /v1/app-user-signin/servers/{serverId}/setup получил блок bitrix24 — { available, reason }. Блок есть, когда приложению раздаётся SDK 0.4 или новее, как и enableFlow; на SDK 0.3 ответ прежний. Блок говорит, сработает ли у приложения на этом сервере вход через Битрикс24, а если нет, называет причину в reason. PLATFORM_UNSUPPORTED — вход через Битрикс24 на этой площадке не предлагается, NO_APPLICATION — у сервера нет карточки приложения, FEATURE_DISABLED — функция не включена для владельца приложения или владельца сервера, SERVER_NOT_BLACKHOLE — сервер не в режиме BLACKHOLE, SERVER_NOT_PUBLIC — сервер открыт не всем (доступ меняет автор на вкладке «Доступ»), SERVER_OWNER_BLOCKED — учётная запись владельца сервера заблокирована или удалена. Пока вход недоступен, ссылке установки администратора нужен client id одного из способов входа из блока env. Исключение — SERVER_NOT_PUBLIC: блок env остаётся пустым, а шаги enableFlow просят открыть приложение для всех на вкладке «Доступ», после чего заработает вход через Битрикс24. Поле docsUrl теперь несёт полный адрес страницы о входе пользователей вместо null.
В группе data.capabilities.appUserSignIn ответа GET /v1/me появился слот bitrix24: предлагается ли вход через Битрикс24 на этой площадке и включена ли функция для владельца ключа (reason — FEATURE_DISABLED или PLATFORM_UNSUPPORTED). Про конкретный сервер слот не говорит — это блок bitrix24 ответа setup. Открытый слот setup теперь несёт endpoint и statusEndpoint — пути настройки и состояния входа — и docs со ссылкой на документацию. Пока функция не включена для владельца ключа, слот setup закрыт и новых полей в нём нет. Остальные поля ответа не меняются.
NEW-1113-3: проверка содержимого и явный повтор загрузки версии на Диск
После таймаута загрузки версии GET /v1/disk/uploads/:operationId может подтвердить applied по SHA-256 текущего файла или подходящей версии. Если доказательства нет, результат остаётся unknown: неизменная история не доказывает отсутствие записи. Агент может после паузы не менее пяти минут создать новую попытку через POST /v1/disk/uploads/reserve с lineage.kind: "retry" и тем же точным намерением, затем отправить исходные байты. Перед повторной отправкой проверяется текущий файл. Совпавшее содержимое даёт applied без новой записи, обнаруженное чужое изменение останавливает отправку. Исходный вызов может завершиться позже; изменение между проверкой и записью также возможно.
Для результата всей цепочки передавайте X-Disk-Upload-Response-Version: 2 в запросах POST /v1/disk/uploads/reserve, POST /v1/disk/uploads, GET /v1/disk/uploads/:operationId и GET /v1/disk/uploads. Без заголовка сохраняется прежний строгий ответ v1 об отдельной попытке.
FIX-1113-4: GET /v1/ai/quota показывает текущий период квоты
Было
Если после завершения 30-дневного периода AI-квоты не было новых списаний, GET /v1/ai/quota показывал даты и расход прошлого периода. Приложение могло принять такую квоту за исчерпанную.
Стало
Ответ показывает текущий период: data.pctUsed равен 0, data.exhausted равен false при положительном лимите, data.period.start — время запроса, data.resetAt — на 30 дней позже, а data.byModel содержит только вызовы текущего периода. После первого списания период начинается с момента списания.
Влияние на интеграторов
Если приложение останавливает запросы при data.exhausted, используйте обновлённое значение из ответа. Формат запроса не меняется. До первого списания data.period.start и data.resetAt сдвигаются вместе со временем запроса.
FIX-1113-5: статические приложения отдают Cache-Control: no-cache
Было
Приложение с runtime: "static", выложенное через POST /v1/infra/servers/:id/deploy, отдавало файлы без заголовка Cache-Control. Браузер сам выбирал срок хранения по дате файла из архива и после новой выкладки мог показывать прежнюю версию.
Стало
Каждый файл такого приложения отдаётся с заголовком Cache-Control: no-cache: браузер хранит копию, но перед показом сверяет её с сервером. Датой файла становится время выкладки, поэтому Last-Modified и ETag меняются с каждой выкладкой, которая меняет файлы приложения.
Влияние на интеграторов
Менять запросы не нужно. Заголовок появляется после следующей выкладки приложения.
FIX-1113-6: Порядок вариантов поля смарт-процесса при PATCH
Было
PATCH /v1/items/{entityTypeId}/userfields/{id} и PATCH /v1/userfields/invoices/{id} с массивом enum отвечали HTTP 200, но изменённый sort варианта не сохранялся. Следующий GET показывал прежнее значение.
Стало
Исправлен случай, когда PATCH с enum возвращал HTTP 200, а следующий GET показывал прежний sort существующего варианта. Ответ остаётся HTTP 200 с { "success": true, "data": { "updated": true } } для корректного массива. Проверяйте новый порядок повторным GET: на некоторых порталах HTTP 200 всё ещё может сопровождаться прежним sort. Переданный в теле userTypeId по-прежнему игнорируется.
Некорректный массив вариантов теперь возвращает HTTP 400 INVALID_ENUM без изменения поля. HTTP 502 BITRIX_ERROR означает, что API не смог проверить принадлежность переданных существующих id этому полю до обновления; поле не изменяется.
Влияние на интеграторов
Корректный запрос менять не нужно. После PATCH сверяйте порядок вариантов повторным GET: HTTP 200 сам по себе не подтверждает сохранение нового sort.
FIX-1113-7: Больше времени на создание снимка базы приложения
Было
На локальный снимок SQLite-базы выделялось 5 секунд. По истечении этого срока снимок прерывался с APP_DB_BACKUP_TIMEOUT. Этот срок действовал для ручных, ежедневных и защитных копий.
Стало
На создание снимка выделяется 45 секунд. Если снимок не завершён за этот срок, копия по-прежнему получает APP_DB_BACKUP_TIMEOUT. Успешное создание копии любого размера не гарантируется.
Влияние на интеграторов
Запрос на создание копии по-прежнему возвращает HTTP 202, копия создаётся в фоновом режиме. Менять запрос не нужно. Для копий, ранее завершившихся со статусом FAILED, нужна новая попытка создания.
Запись в базу может дольше ждать готовности защитной копии. Пока копия готовится, вызов записи возвращает 409 APP_DB_BACKUP_NOT_READY с заголовком Retry-After. Повторяйте вызов после указанной паузы. Отдельный HTTP-запрос на всё время подготовки не удерживается. Создание копии может занимать до нескольких минут: 45 секунд — срок только локального снимка, а не всей подготовки копии.
Защитные копии перед восстановлением и удалением приложения используют тот же срок снимка, поэтому подготовка этих операций может занять больше времени.
Затронутые эндпоинты: POST /v1/infra/servers/:id/db/backups, POST /v1/infra/servers/:id/db/execute, POST /v1/infra/servers/:id/db/tables/:table/rows, PATCH /v1/infra/servers/:id/db/tables/:table/rows/:key, DELETE /v1/infra/servers/:id/db/tables/:table/rows/:key, POST /v1/infra/servers/:id/db/restore, DELETE /v1/infra/servers/:id
NEW-1113-8: замена сервера приложения сообщает о смене секрета входа
POST /v1/applications/{id}/replace-server теперь называет смену секрета входа в data.warnings значением LOGIN_SECRET_ROTATED. Оно приходит, когда у приложения встроенный вход, а прежний сервер принадлежал не владельцу карточки: пользователи приложения выйдут из аккаунтов, админку приложения открывают только владельцы, настройки почты (SMTP) в админке приложения нужно ввести заново. Ответ остаётся HTTP 200 с прежними полями. Повтор с тем же Idempotency-Key по-прежнему отдаёт пустой data.warnings.
NEW-1113-9: Коворк/Код: признак `opened` у личных окон лимита
На портале с включёнными личными AI-лимитами у каждого окна лимита появился признак opened: в GET /v1/cowork/state и в ответе POST /v1/cowork/subscription/resume это windows.<окно>.opened, в GET /v1/cowork/me — карта opened: { fiveHour, week, month } рядом с quotaPct, в партнёрском /api/b24/* — windows.<окно>.opened. false значит, что окно начнётся с первого запроса. resetAt при этом остаётся для совместимости. На порталах без личных лимитов поля нет.
NEW-1113-10: право pull_channel доступно на всех порталах
Право pull_channel больше не ограничено порталами с включённой поддержкой канала Pull (NEW-1001-33): его можно выбрать при создании ключа или приложения на любом портале. Ключи, у которых право уже есть, работают как прежде.
NEW-1113-11: Генерация сайта по описанию
Добавлены запуск генерации сайта, получение статуса, словарь полей и чтение одного поля. Запуск принимает Idempotency-Key клиента; повтор завершённого запроса с тем же ключом возвращает сохранённый ответ в течение 24 часов. Генерация занимает свободный черновик ИИ-сайта пользователя. Получение статуса требует разрешённой записи и не повторяется автоматически после 5xx. Пустой или пробельный Idempotency-Key считается отсутствующим.
Затронутые эндпоинты: POST /v1/sites/ai/generate, GET /v1/sites/ai/status, GET /v1/sites/ai/fields, GET /v1/sites/ai/fields/{name}
NEW-1113-12: первые шаги новичка в Коворк/Код хранятся по аккаунту
GET /v1/cowork/me возвращает блок onboarding с моментами первого отправленного запроса (firstPromptAt) и первого готового ответа (firstAnswerAt). Признак общий для всех устройств человека на портале, поэтому подсказки новичка не показываются повторно на другом компьютере. Если у места уже есть расход Коворк/Код, оба момента приходят заполненными и без отметки, а флаг inferred равен true.
BC-1113-13: квота компании не отдаётся ключу подписки Коворк/Код
Поддержка старого формата до: не предусмотрена
Было
GET /v1/ai/quota отвечал ключу подписки Коворк/Код со скоупом vibe:cowork тем же ответом, что и любому ключу портала: процентами AI-квоты компании и признаком exhausted. Вызовы такого ключа эту квоту не расходуют, поэтому ответ не описывал его лимиты, а exhausted: true выглядел как исчерпание подписки.
Стало
Ключ со скоупом vibe:cowork получает 403 company_ai_quota_not_applicable. Остальные ключи получают прежний ответ.
Что делать интеграторам
Лимиты подписки Коворк/Код читайте через GET /v1/cowork/me: поля quotaPct и resetAt по окнам пяти часов, недели и месяца. Квоту компании запрашивайте ключом без скоупа vibe:cowork.
NEW-1113-14: Поле publicCheckout в блоке features ответа GET /v1/cowork/me
GET /v1/cowork/me отдаёт в блоке features поле publicCheckout: true, когда пополнение и смена тарифа этого аккаунта оплачиваются на публичной странице оплаты Битрикс24 без входа в аккаунт. Нет поля — оплата идёт в кассе внутри аккаунта. Для коробочного Битрикс24 поля нет. Блок features приходит, только когда для аккаунта включена хотя бы одна возможность. Остальные поля ответа не изменились.