# Як переглянути й відновити версію дії в ActionJail

Редактор дії зберігає історію версій коду, параметрів і документації за останні 180 днів: хто, коли й що змінив. Старішу версію можна порівняти з поточною й відновити одним кліком.

---

## Коли стане в пригоді
- Після правки дія працює інакше, ніж раніше, і треба побачити, що змінилось.
- Потрібно повернути код, параметри чи документацію до попередньої версії.

---

## Що важливо знати
- Версія — це зміна коду (`Код`), JSON-конфігу (`Параметри`) або документації. Назва, опис і група дії у версії не входять.
- Історія ведеться в журналі налаштувань. Якщо журнал вимкнено, історії нема: кнопка покаже відповідне повідомлення.
- Версії зберігаються 180 днів від останньої зміни. Старіші зникають.
- Повторне «Зберегти» без змін нової версії не створює.
- Відновлення не змінює стан дії (активна, список ботів): вимкнена дія лишається вимкненою.
- Токени в коді, параметрах і документації в історії замасковано (`••••••`). Це стосується лише відомих шаблонів (заголовки `Authorization`, `api_key`, `client_secret` тощо); токен, записаний у змінну довільної назви або з ключем у лапках (`'api_key': '…'`), маска не побачить. Актуальний токен і далі видно в редакторі, тож безпечніше зберігати токени в «Облікових даних інстансу». Відновлення повертає справжній код, а не замаскований.
- Видалену дію відновити не можна, а її історії не видно.

---

## Перед початком
- [ ] Відкрито `Меню -> ActionJail`, обрано власну (не системну) дію.
- [ ] Є право зберігати дії: окремого права на історію нема.

---

## Покрокова інструкція
1. Відкрийте дію й натисніть `Історія` поряд із `Зробити копію`.
2. У списку (від нової до старої) знайдіть версію: дата, автор, джерело (`Редактор`, `API`, `Агент`, `MCP`, `Маркетплейс`, `Система`) і що змінилось.
3. `З поточною` показує різницю між версією й поточним станом, `З попередньою` — що саме змінила ця версія.
4. Натисніть `Відновити`. У вікні перегляньте різницю й, за потреби, попередження «Після цієї версії дію змінювали N раз(и)».
5. Підтвердіть. З'явиться повідомлення «Версію відновлено», історія оновиться, у ній буде новий запис «Відновлено з версії від …».

---

## Що відбувається після
- Код, параметри й документація дії стають такими, як у вибраній версії; дія проходить ту саму перевірку, що й «Зберегти».
- Незбережені зміни в редакторі буде втрачено.
- Рядок «Зміна поза історією» означає, що між двома версіями дію змінили, коли журнал був вимкнений. Рядок «Стан до першої зміни в історії» дає змогу повернути код, який був до першого запису.

---

## Як переконатися, що все вдалось
- У списку є новий запис із позначкою `Поточна` й підписом «Відновлено з версії від …».
- Тест дії дає результат старої версії.

---

## Якщо не виходить
- «Дію змінили, поки ви дивились історію»: оновіть історію й повторіть.
- «Цю версію не можна відновити автоматично»: запис створено до появи історії версій, скопіюйте потрібне вручну.
- Вікно показує помилку перевірки: код старої версії порушує поточні правила безпеки ActionJail, відновити його не можна.

---

## Пов'язані інструкції
- [Створити й підтримувати дію (Адміністратор)](/uk/actionjail/how-to/admin-manage-actions.md)
- [Клонувати дію](/uk/actionjail/how-to/clone-action.md)
- [Використати збережені облікові дані в дії](/uk/actionjail/how-to/use-saved-credential-in-custom-action.md)

<!-- Скріншоти й GIF: кнопка «Історія», список версій, діалог відновлення — додасть демо. -->