***

title: Version Control
slug: version-control
description: >-
Learn how to manage, track, and roll back changes to your agents and
documentation in Synthflow.
---------------------------

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

## 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 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.

## 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.

## Frequently Asked Questions

<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 Prompt and Flow Designer agents?">
  Yes. Version control is available for both Prompt agents and Flow Designer agents, so you can track and manage changes across all agent types.
</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?">
  Currently, changes made directly via the API are <b>not</b> tracked in the version control system. Only changes made through the Synthflow UI are versioned.
</Accordion>

<Accordion title="Are actions versioned as well?">
  No, actions are not currently included in version control. If you update or modify actions, those changes will not be tracked in the version history.
</Accordion>

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