
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.
Synthflow provides built-in versioning for both Single-Prompt and Flow Designer agents:
Only changes made through the Synthflow UI are tracked. Direct API edits are not versioned, and actions are not yet included in version history.
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.
Imported agent configurations do not include actions or knowledge bases. You will need to re-add these manually after importing.
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.
Yes. In the agent editor, open the version history, select the version you want, and click Restore.
Yes. Version control is available for both agent types, so you can track and manage changes across all of them.
Use the Compare feature in the version history to view differences between any two versions.
No. Changes made directly via the API are not tracked. Only edits made through the Synthflow UI are versioned.
No, actions are not currently included in version control. Updates or modifications to actions will not appear in the version history.
No. Agent versioning is not currently exposed through the public API. Only changes made through the Synthflow UI are tracked.