> ## Documentation Index
> Fetch the complete documentation index at: https://docs.volubile.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration history

> Configuration history allows you to track all changes made to your agent, view previous versions, and restore old configurations.

## Overview

Configuration history maintains a complete record of all changes made to your agent. Each save creates a new version, allowing you to:

* View the evolution of your agent's configuration over time
* Compare different configuration versions
* Restore a previous version when needed
* Work on modifications without impacting ongoing calls

<Frame>
  <img src="https://mintcdn.com/weengage/1STKBOQ8nOwjQf0A/images/agents/configuration/volubile-configuration-history-panel.png?fit=max&auto=format&n=1STKBOQ8nOwjQf0A&q=85&s=209561d9f3ce90f4912c87a782661a24" width="2352" height="1797" data-path="images/agents/configuration/volubile-configuration-history-panel.png" />
</Frame>

## Draft vs production versions

### Production version

The production version is the active configuration used to handle incoming calls. This is the version your callers experience when they contact your agent.

<Note>
  Only one version can be in production at a time. This version is identified by a checkmark icon in the history.
</Note>

### Draft versions

Draft versions are modified configurations that are not yet deployed to production. They allow you to:

* Prepare changes without impacting ongoing calls
* Test different configurations before production deployment
* Collaborate on changes without disrupting service

<Info>
  Draft versions are automatically created when you modify the configuration of a production agent. Callers continue to use the production version while you work on the draft.
</Info>

## Accessing history

To access configuration history:

<Steps>
  <Step title="Open the history panel">
    From your agent's configuration page, click the history icon in the top right corner of the interface.
  </Step>

  <Step title="Browse versions">
    The panel displays all saved versions, with each version showing:

    * Creation date and time
    * Version number (#0, #1, #2, etc.)
    * Author of the modification (if available)
    * Status (production or draft)
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/weengage/1STKBOQ8nOwjQf0A/images/agents/configuration/volubile-configuration-history-list.png?fit=max&auto=format&n=1STKBOQ8nOwjQf0A&q=85&s=60304db68f00d2769ebddbe76de6b06c" width="641" height="1023" data-path="images/agents/configuration/volubile-configuration-history-list.png" />
</Frame>

## Viewing an old version

To view a previous configuration:

1. Open the history panel
2. Click the "eye" icon next to the desired version
3. The configuration displays in read-only mode

<Warning>
  When viewing an old version, a warning banner appears at the top of the page to remind you that you're viewing a configuration that is not currently in production.
</Warning>

<Frame>
  <img src="https://mintcdn.com/weengage/1STKBOQ8nOwjQf0A/images/agents/configuration/volubile-viewing-old-version.png?fit=max&auto=format&n=1STKBOQ8nOwjQf0A&q=85&s=7a63977e885c667ffe97d563e2927fc6" width="2361" height="1788" data-path="images/agents/configuration/volubile-viewing-old-version.png" />
</Frame>

From this viewing mode, you can:

* Review the complete configuration at that date
* Return to the current version via the link in the banner
* Restore this version if necessary
* Reopen the history to navigate to other versions

## Comparing versions (diff)

When viewing a previous version, text fields display a visual diff highlighting the differences with the current version:

* **Removed text** appears in red with a strikethrough
* **Added text** appears in green

This diff view is available for the following fields, depending on the agent type:

* **For standard agents**:
  * Initial message
  * Main prompt
  * Answering machine message

* **For TruePath agents**:
  * General behavior prompt
  * LLM prompt
  * Say message

<Frame>
  <img src="https://mintcdn.com/weengage/LFr6NZKRemjlo3PT/images/agents/configuration/volubile-configuration-history-diff.png?fit=max&auto=format&n=LFr6NZKRemjlo3PT&q=85&s=dc94b1fab8bbbaa4368f783e4419c0d2" width="1242" height="313" data-path="images/agents/configuration/volubile-configuration-history-diff.png" />
</Frame>

<Tip>
  Use the diff view to quickly understand what changed between two versions, without having to read the entire configuration.
</Tip>

## Restoring a version

To put a previous configuration back into production:

<Steps>
  <Step title="Select the version">
    In the history panel, click the restore icon (circular arrow) next to the version to restore.
  </Step>

  <Step title="Confirm restoration">
    A confirmation window appears asking you to validate the action.

    <Frame>
      <img src="https://mintcdn.com/weengage/1STKBOQ8nOwjQf0A/images/agents/configuration/volubile-restore-confirmation.png?fit=max&auto=format&n=1STKBOQ8nOwjQf0A&q=85&s=9484c153b4218131fd70e4817efe0397" width="906" height="332" data-path="images/agents/configuration/volubile-restore-confirmation.png" />
    </Frame>
  </Step>

  <Step title="Validation">
    Click **Validate** to restore the version. A new version will be created with the content of the restored version, and it will automatically become the production version.
  </Step>
</Steps>

<Info>
  Restoration does not delete intermediate versions. It creates a new version with the content of the restored version. The complete history is preserved.
</Info>

## Filtering history

The history panel offers filtering options to facilitate navigation through versions:

<Frame>
  <img src="https://mintcdn.com/weengage/1STKBOQ8nOwjQf0A/images/agents/configuration/volubile-configuration-history-filters.png?fit=max&auto=format&n=1STKBOQ8nOwjQf0A&q=85&s=f784365727fb35febc0f99e83a02bdad" width="650" height="420" data-path="images/agents/configuration/volubile-configuration-history-filters.png" />
</Frame>

### Date filter

Use the "Before the date" filter to display only versions created before a specific date. This is particularly useful when searching for a configuration at a specific time.

### Hide draft versions

Enable the "Hide draft versions" option to see only versions that have been deployed to production. This simplifies the view when you have many working versions.

## Version retention

<Note>
  All versions are retained indefinitely. You can go back as far as necessary in your agent's history, up to its initial creation.
</Note>

## Use cases

### Undo problematic changes

If a recent update causes issues, quickly restore the previous production version to restore service.

### Compare performance periods

Review configurations used at different periods to understand the impact of changes on your agent's performance.

### Audit and compliance

Keep a complete record of all changes made to your agent for audit or compliance needs.

### Recover deleted configuration

If you accidentally deleted a configuration element, find it in a previous version and restore it.

<Tip>
  Before making significant changes, note the number of the current production version. This will facilitate restoration if necessary.
</Tip>