For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
AcademyContact SalesHelp CenterDashboard
DocumentationAPI ReferenceIntegrationsAdministrationChangelog
DocumentationAPI ReferenceIntegrationsAdministrationChangelog
  • Get Started
    • Introduction
    • Aurora
  • Build
    • Create an Agent
    • The Agent Editor
    • Single-Prompt Agents
    • Memory
    • Knowledge Base
    • Variables
    • Version Control
  • Evaluate
    • Manual Testing
    • Custom Evaluations
    • Simulations
  • Launch
    • Deployment Options
    • WhatsApp
    • Website and Apps
    • Launching a Chat Agent
    • Workflows
  • Learn
    • Analytics Dashboard
    • Logs
    • Export Call Data
  • Legal
    • Subscriber Terms
    • GTC - Direct Use (DACH)
    • GTC - Direct Use (US)
    • GTC - Distribution (DACH)
    • GTC - Distribution (US)
    • Business Associate Agreement
    • Privacy Policy
    • Imprint
    • AI Transparency Statement
    • Trust Vault
LogoLogo
AcademyContact SalesHelp CenterDashboard
On this page
  • Why use version control?
  • How version control works in Synthflow
  • Exporting and importing agent configurations
  • Drafts and state management
  • FAQ
Build

Version Control

Track, restore, and audit agent changes over time
||View as Markdown|
Was this page helpful?
Previous

Manual Testing

Next
Built with

Version History panel listing four agent versions, with V4 (ElevenLabs v3) marked as Published and V3, V2, and V1 marked as Archive

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.

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

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.

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

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

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.

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.

How do I see what changed between versions?

Use the Compare feature in the version history to view differences between any two versions.

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.

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.

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.