# ONAPPUPDATE

URL: https://chugunov.pro/api-bitrix24/common/events/on-app-update/
Проверено на Битрикс24 REST API, обновлено 11.09.2026 (ревизия источника fb39d6c).
Источник: официальная документация Битрикс24 (bitrix-tools/b24-rest-docs, лицензия MIT, © Bitrix). Справочник независимый, официальной документацией не является.

Событие после обновления приложения OnAppUpdate
Scope: `базовый`
Кто может подписаться: любой пользователь

## Описание

Событие `ONAPPUPDATE` вызывается после установки новой версии приложения в Битрикс24. Событие передает информацию о текущей и предыдущей версиях приложения, а также обновленный `application_token`. Подробнее читайте в статье [Safe event handlers](https://apidocs.bitrix24.ru/api-reference/events/safe-event-handlers.html).

## Параметры

- `event` `string` — обязательный. Символьный код события. В данном случае — `ONAPPUPDATE`
- `data` `object` — обязательный. Данные об обновлении приложения.
  Структура описана [ниже](#data)
- `ts` `timestamp` — обязательный. Дата и время отправки события из очереди
- `auth` `object` — обязательный. Объект с параметрами авторизации и данными о Битрикс24, в котором произошло событие.
  Структура описана [ниже](#auth)

### Параметр data

- `VERSION` `string` — обязательный. Текущая установленная версия приложения
- `PREVIOUS_VERSION` `string` — обязательный. Предыдущая версия до обновления
- `LANGUAGE_ID` `string` — обязательный. Установленный язык: `ru`, `en` и другие

### Параметр auth

- `domain` `string` — обязательный. Адрес Битрикс24, на котором произошло событие
- `scope` `string` — обязательный. Список прав, выданных приложению, через пробел
- `access_token` `string` — обязательный. Токен авторизации OAuth 2.0
- `refresh_token` `string` — обязательный. Токен для продления авторизации OAuth 2.0
- `expires_in` `integer` — обязательный. Время жизни токена доступа в секундах
- `server_endpoint` `string` — обязательный. Адрес сервера авторизации Битрикс24, необходимый для обновления токенов OAuth 2.0
- `status` `string` — обязательный. Статус приложения, подписавшегося на это событие:
  - `L` — локальное приложение
  - `F` — бесплатное тиражное приложение
  - `S` — подписное тиражное приложение
- `client_endpoint` `string` — обязательный. Общий путь для вызовов методов API Битрикс24
- `member_id` `string` — обязательный. Уникальный идентификатор Битрикс24
- `application_token` `string` — обязательный. Токен для безопасной обработки событий

Оригинал в официальной документации: https://apidocs.bitrix24.ru/api-reference/common/events/on-app-update.html