# Изменения API: 13 ноября 2026

[← Журнал изменений](/docs/changelog) · [Ноябрь 2026](/docs/changelog/2026-11)

### BC-1113-1: чужой id варианта перечисления отклоняется до записи поля

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

**Было**

[POST /v1/items/{entityTypeId}/userfields](/docs/userfields/smart-processes/create) с положительным `id` варианта, который принадлежит другому полю, отвечал `201`, а созданное поле приходило без вариантов. [PATCH /v1/userfields/{entity}/{id}](/docs/userfields/crm/update) с таким `id` в `list` отвечал `200`, а перечисление оставалось прежним. Вариант не записывался, хотя ответ говорил об успехе.

**Стало**

Оба запроса отклоняются до записи: `400 INVALID_ENUM`, ничего не записывается. На изменении поля текущие варианты читаются заранее, и `id` сверяется с ними. Если текущие варианты прочитать не удалось, запрос не отклоняется: поле обновляется, а передачу вариантов проверяет Битрикс24. Варианты без `id` и варианты с `id` этого же поля работают как раньше: на создании поле получает новые варианты, на изменении остаются переданные.

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

На создании поля передавайте варианты без `id`. На изменении передавайте `id` из ответа [GET /v1/userfields/{entity}/{id}](/docs/userfields/crm/get), а новый вариант добавляйте без `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](/docs/disk/uploads-get) может подтвердить `applied` по SHA-256 текущего файла или подходящей версии. Если доказательства нет, результат остаётся `unknown`: неизменная история не доказывает отсутствие записи. Агент может после паузы не менее пяти минут создать новую попытку через [POST /v1/disk/uploads/reserve](/docs/disk/uploads-reserve) с `lineage.kind: "retry"` и тем же точным намерением, затем отправить исходные байты. Перед повторной отправкой проверяется текущий файл. Совпавшее содержимое даёт `applied` без новой записи, обнаруженное чужое изменение останавливает отправку. Исходный вызов может завершиться позже; изменение между проверкой и записью также возможно.

Для результата всей цепочки передавайте `X-Disk-Upload-Response-Version: 2` в запросах [POST /v1/disk/uploads/reserve](/docs/disk/uploads-reserve), [POST /v1/disk/uploads](/docs/disk/uploads), [GET /v1/disk/uploads/:operationId](/docs/disk/uploads-get) и [GET /v1/disk/uploads](/docs/disk/uploads-list). Без заголовка сохраняется прежний строгий ответ v1 об отдельной попытке.

### FIX-1113-4: GET /v1/ai/quota показывает текущий период квоты

**Было**

Если после завершения 30-дневного периода AI-квоты не было новых списаний, [GET /v1/ai/quota](/docs/ai/consumption/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](/docs/infra/deploy/deploy), отдавало файлы без заголовка `Cache-Control`. Браузер сам выбирал срок хранения по дате файла из архива и после новой выкладки мог показывать прежнюю версию.

**Стало**

Каждый файл такого приложения отдаётся с заголовком `Cache-Control: no-cache`: браузер хранит копию, но перед показом сверяет её с сервером. Датой файла становится время выкладки, поэтому `Last-Modified` и `ETag` меняются с каждой выкладкой, которая меняет файлы приложения.

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

Менять запросы не нужно. Заголовок появляется после следующей выкладки приложения.

### FIX-1113-6: Порядок вариантов поля смарт-процесса при PATCH

**Было**

[PATCH /v1/items/{entityTypeId}/userfields/{id}](/docs/userfields/smart-processes/update) и `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](/docs/infra/database/snapshot), [POST /v1/infra/servers/:id/db/execute](/docs/infra/database/execute), [POST /v1/infra/servers/:id/db/tables/:table/rows](/docs/infra/database/rows-create), [PATCH /v1/infra/servers/:id/db/tables/:table/rows/:key](/docs/infra/database/rows-update), [DELETE /v1/infra/servers/:id/db/tables/:table/rows/:key](/docs/infra/database/rows-delete), [POST /v1/infra/servers/:id/db/restore](/docs/infra/database/restore), [DELETE /v1/infra/servers/:id](/docs/infra/servers/delete)

### NEW-1113-8: замена сервера приложения сообщает о смене секрета входа

[POST /v1/applications/{id}/replace-server](/docs/applications/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](/docs/entities/sites/ai/generate), [GET /v1/sites/ai/status](/docs/entities/sites/ai/status), [GET /v1/sites/ai/fields](/docs/entities/sites/ai/fields), [GET /v1/sites/ai/fields/{name}](/docs/entities/sites/ai/field)

### NEW-1113-12: первые шаги новичка в Коворк/Код хранятся по аккаунту

[GET /v1/cowork/me](/docs/cowork/me) возвращает блок `onboarding` с моментами первого отправленного запроса (`firstPromptAt`) и первого готового ответа (`firstAnswerAt`). Признак общий для всех устройств человека на портале, поэтому подсказки новичка не показываются повторно на другом компьютере. Если у места уже есть расход Коворк/Код, оба момента приходят заполненными и без отметки, а флаг `inferred` равен `true`.

### BC-1113-13: квота компании не отдаётся ключу подписки Коворк/Код

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

**Было**

[GET /v1/ai/quota](/docs/ai/consumption/quota) отвечал ключу подписки Коворк/Код со скоупом `vibe:cowork` тем же ответом, что и любому ключу портала: процентами AI-квоты компании и признаком `exhausted`. Вызовы такого ключа эту квоту не расходуют, поэтому ответ не описывал его лимиты, а `exhausted: true` выглядел как исчерпание подписки.

**Стало**

Ключ со скоупом `vibe:cowork` получает `403 company_ai_quota_not_applicable`. Остальные ключи получают прежний ответ.

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

Лимиты подписки Коворк/Код читайте через [GET /v1/cowork/me](/docs/cowork/me): поля `quotaPct` и `resetAt` по окнам пяти часов, недели и месяца. Квоту компании запрашивайте ключом без скоупа `vibe:cowork`.

### NEW-1113-14: Поле publicCheckout в блоке features ответа GET /v1/cowork/me

[GET /v1/cowork/me](/docs/cowork/me) отдаёт в блоке `features` поле `publicCheckout: true`, когда пополнение и смена тарифа этого аккаунта оплачиваются на публичной странице оплаты Битрикс24 без входа в аккаунт. Нет поля — оплата идёт в кассе внутри аккаунта. Для коробочного Битрикс24 поля нет. Блок `features` приходит, только когда для аккаунта включена хотя бы одна возможность. Остальные поля ответа не изменились.
