> For a complete page index, fetch https://docs.synthflow.ai/llms.txt. For full documentation content, fetch https://docs.synthflow.ai/llms-full.txt.

# Version Control

> Learn how to track, restore, and audit changes to your agents in Synthflow.

![Version History panel listing four agent versions, with V4 (ElevenLabs v3) marked as Published and V3, V2, and V1 marked as Archive](https://files.buildwithfern.com/synthflow.docs.buildwithfern.com/9746d58f554301b9ea852cf4ef4a3379c5addc12dfc9727b3f8b21ef35c004d2/docs/assets/screenshots/version_control_1.png)

Version control helps you manage changes to your agents over time. With Synthflow, you can track edits, collaborate safely, and restore previous versions if needed.

Use version control when you want a safer workflow for prompt changes, Flow Designer edits, or team collaboration. It gives you a publish history and rollback path, but it does not cover every object in the platform.

## Why use version control?

* **Track changes:** See who changed what and when.
* **Collaborate:** Work with your team without overwriting each other's work.
* **Rollback:** Restore previous versions if something goes wrong.
* **Audit:** Maintain a history for compliance and troubleshooting.

## How version control works in Synthflow

Synthflow provides built-in versioning for both Single-Prompt and Flow Designer agents:

* **Automatic versioning:** Each time you publish or update an agent, a new version is created automatically.
* **Change history:** View a timeline of changes, including who made them and what was changed.
* **Restore:** Revert to any previous version with a single click.
* **Compare:** See differences between versions to understand what changed.

<Note>
  Only changes made through the Synthflow UI are tracked. Direct API edits are not versioned, and actions are not yet included in version history.
</Note>

## Exporting and importing agent configurations

You can export and import a `.json` file containing your agent's configuration. This allows you to quickly create a new agent with the same setup or transfer configurations between workspaces.

<Warning>
  Imported agent configurations do not include actions or knowledge bases. You will need to re-add these manually after importing.
</Warning>

## Drafts and state management

When you make changes to an agent, a new draft version is created automatically. Drafts remain unpublished until you choose to publish. Once published, all live traffic is routed to the latest published version.

## FAQ

<AccordionGroup>
  <Accordion title="Can I roll back to a previous version of my agent?">
    Yes. In the agent editor, open the version history, select the version you want, and click **Restore**.
  </Accordion>

  <Accordion title="Does version control apply to both Single-Prompt and Flow Designer agents?">
    Yes. Version control is available for both agent types, so you can track and manage changes across all of them.
  </Accordion>

  <Accordion title="How do I see what changed between versions?">
    Use the **Compare** feature in the version history to view differences between any two versions.
  </Accordion>

  <Accordion title="Are changes made via the API version controlled?">
    No. Changes made directly via the API are **not** tracked. Only edits made through the Synthflow UI are versioned.
  </Accordion>

  <Accordion title="Are actions versioned as well?">
    No, actions are not currently included in version control. Updates or modifications to actions will not appear in the version history.
  </Accordion>

  <Accordion title="Is agent versioning available via the public API?">
    No. Agent versioning is not currently exposed through the public API. Only changes made through the Synthflow UI are tracked.
  </Accordion>
</AccordionGroup>