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

# Version History

> Track changes and restore previous versions

Version History tracks snapshots of your flow agent, allowing you to review changes and restore previous states.

## Overview

Each version captures:

* Agent configuration (name, system prompt, settings)
* All nodes and their configurations
* All edges and transitions
* Voice and environment settings

## Viewing Version History

1. Open your flow agent in the Flow Builder
2. Click **Settings** → **Version History**
3. Browse the timeline of versions

### Version Information

Each version shows:

| Field             | Description                      |
| ----------------- | -------------------------------- |
| **Version #**     | Sequential version number        |
| **Date/Time**     | When the version was created     |
| **Created By**    | Who saved the version            |
| **Node Count**    | Number of nodes in this version  |
| **Edge Count**    | Number of connections            |
| **Restored From** | If restored from another version |

## Creating Versions

Versions are created automatically when:

* You save the flow
* You activate/deactivate the agent
* You restore from a previous version

### Manual Version Notes

Add notes when saving important milestones:

```
Version 12: "Added Spanish language support"
Version 13: "Fixed billing transition bug"
Version 14: "Pre-launch final version"
```

## Restoring Versions

To restore a previous version:

1. Open Version History
2. Find the version you want
3. Click **Restore**
4. Confirm the restoration
5. A new version is created with the restored content

<Warning>
  Restoring creates a new version. Your current work becomes the previous version and isn't lost.
</Warning>

### What Gets Restored

| Restored             | Not Restored             |
| -------------------- | ------------------------ |
| Node configurations  | Phone number assignments |
| Edge connections     | Call history             |
| System prompt        | Analytics data           |
| Voice settings       | Knowledge base content   |
| Environment settings |                          |

## Use Cases

<AccordionGroup>
  <Accordion title="Rollback after issues">
    **Scenario**: You pushed a change that broke the flow.

    **Solution**:

    1. Deactivate the agent
    2. Open Version History
    3. Restore the last working version
    4. Reactivate
  </Accordion>

  <Accordion title="Compare versions">
    **Scenario**: You want to see what changed between versions.

    **Solution**:

    1. Note the configuration in the current version
    2. Restore an older version (temporarily)
    3. Compare the differences
    4. Restore the newer version if needed
  </Accordion>

  <Accordion title="Experiment safely">
    **Scenario**: You want to try major changes without risk.

    **Solution**:

    1. Save current version as a checkpoint
    2. Make experimental changes
    3. Test thoroughly
    4. Keep or restore as needed
  </Accordion>
</AccordionGroup>

## Version Timeline

Versions form a linear timeline:

```
v1 → v2 → v3 → v4 → v5 (current)
         ↑
         Restored from v2 creates v6
```

Restoring doesn't replace the timeline—it adds a new version.

## Best Practices

<CardGroup cols={2}>
  <Card title="Save Before Big Changes" icon="shield">
    Create a checkpoint before major modifications.
  </Card>

  <Card title="Name Important Versions" icon="tag">
    Add notes to milestone versions for easy identification.
  </Card>

  <Card title="Review Before Restoring" icon="eye">
    Check what's in a version before restoring.
  </Card>

  <Card title="Don't Panic" icon="heart">
    Your current work is never lost—it becomes the previous version.
  </Card>
</CardGroup>

## Version Limits

| Limit              | Value      |
| ------------------ | ---------- |
| Versions per agent | Unlimited  |
| Version retention  | Indefinite |
| Restore speed      | Instant    |

## Related

<CardGroup cols={2}>
  <Card title="Publishing" icon="rocket" href="/publish/publishing">
    Go live with your agent
  </Card>

  <Card title="Flow Canvas" icon="diagram-project" href="/agent-builder/flow-canvas">
    Edit your flow
  </Card>
</CardGroup>