Change agents and workflows safely: save new versions, test them, promote, roll back
Agents and workflows keep a history of versions. Exactly one version is current; runs use it unless they ask for another. This lets you change a live agent or workflow without disturbing the runs that depend on it.
Overwrites the version you are editing. If that is the current version, every run from now on uses the change
New version
Edit → Save as new version
PUT …/<id>?create_new_version=true
Creates the next version number. It is not current: runs keep using the current version until you promote the new one
Saving a new version does not make it current. If your change seems to have no effect, check the Current badge: the new version probably still needs to be promoted.
A workflow that references an agent or a sub-workflow without a version (support/triage) uses that agent’s current version at run time, so promoting the agent changes the workflow’s behaviour too.
Pin a reference with @<n> (support/triage@3) when a workflow must not change until you decide.
Functions are not versioned: updating one changes every workflow that uses it immediately.
Treat the YAML in the app as a deployment target, not the source of truth: keep agents, workflows and functions in git, and deploy them with a script that saves a new version and promotes it. See Deploying from git.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Wavefront AI | Rootflo","colors":{"primary":"#3B82F6","light":"#60A5FA","dark":"#1E40AF"},"logo":{"light":"https://mintcdn.com/rootfloai/AiHxIkh9KtGYiz8E/logo/light.png?fit=max\u0026auto=format\u0026n=AiHxIkh9KtGYiz8E\u0026q=85\u0026s=b493e8fe23f59899d246e2ca32396012","dark":"https://mintcdn.com/rootfloai/AiHxIkh9KtGYiz8E/logo/dark.png?fit=max\u0026auto=format\u0026n=AiHxIkh9KtGYiz8E\u0026q=85\u0026s=cc952b50a8b76554187f5472425ec816"},"favicon":"https://mintcdn.com/rootfloai/ESOMPNB1NNLp7sKF/favicon.png?fit=max\u0026auto=format\u0026n=ESOMPNB1NNLp7sKF\u0026q=85\u0026s=bcf18853f4828199e6cb71af384a8748","navbar":{"links":[{"href":"https://rootflo.ai","label":"Website"}],"primary":{"type":"button","label":"Contact us","href":"mailto:sales@rootflo.ai?subject=Partnership%20Inquiry\u0026body=Hi%2C%0A%0AI%20would%20like%20to%20know%20more%20about%20your%20Wavefront%20Enterprise%20AI%20Platform.%0A%0AThanks%2C%0A%0A"}},"footer":{"socials":{"x":"https://x.com/rootflo_ai","github":"https://github.com/rootflo/wavefront","linkedin":"https://linkedin.com/company/rootflo","discord":"https://discord.gg/BPXsNwfuRU"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/rootflo/flo-ai"},{"anchor":"Discord","icon":"comments","href":"https://discord.gg/BPXsNwfuRU"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"rootfloai","hasAudioNarration":false,"actualSubdomain":"rootfloai","customDomains":["wavefront.rootflo.ai"],"gitSource":{"type":"github","owner":"rootflo","repo":"wavefront","deployBranch":"develop","contentDirectory":"documentation","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad873e433c6f36d82f3b613","collectionId":"c73d5747-f7b7-442a-8b52-1b1ffc5e612b","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad873e433c6f36d82f3b613"},"entitlements":{},"buildId":"6ad873e433c6f36d82f3b613","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"Wavefront","count":38},{"language":"default","tag":"FloAI","count":13},{"language":"default","tag":"Getting started","count":8},{"language":"default","tag":"Workflows","count":7},{"language":"default","tag":"Core Features","count":5},{"language":"default","tag":"Models and agents","count":5},{"language":"default","tag":"Data, files and configuration","count":5},{"language":"default","tag":"Run and integrate","count":5},{"language":"default","tag":"Advanced","count":4},{"language":"default","tag":"Guides","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"wavefront/versions","slug":"/wavefront/versions","pageMetadata":{"title":"Versions","description":"Change agents and workflows safely: save new versions, test them, promote, roll back","icon":"code-compare","href":"/wavefront/versions"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Change agents and workflows safely: save new versions, test them, promote, roll back\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Agents and workflows keep a history of `,_jsx(_components.strong,{children:`versions`}),`. Exactly one version is `,_jsx(_components.strong,{children:`current`}),`; runs use it unless they ask for another. This lets you change a live agent or workflow without disturbing the runs that depend on it.`]}),`\n`,_jsx(Heading,{level:`2`,id:`the-two-ways-to-save-a-change`,children:`The two ways to save a change`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{}),_jsx(_components.th,{children:`Console`}),_jsx(_components.th,{children:`API`}),_jsx(_components.th,{children:`Effect`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Edit in place`})}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Edit → Save`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`PUT …/\u003cid>`})}),_jsx(_components.td,{children:`Overwrites the version you are editing. If that is the current version, every run from now on uses the change`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`New version`})}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Edit → Save as new version`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`PUT …/\u003cid>?create_new_version=true`})}),_jsxs(_components.td,{children:[`Creates the next version number. It is `,_jsx(_components.strong,{children:`not current`}),`: runs keep using the current version until you promote the new one`]})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Saving a new version does not make it current. If your change seems to have no effect, check the `,_jsx(_components.strong,{children:`Current`}),` badge: the new version probably still needs to be promoted.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`a-safe-change-step-by-step`,children:`A safe change, step by step`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Save as new version.`}),` It gets the next number, for example v4, while v3 stays current.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Test it.`}),` In the console, pick v4 in the version selector and use the test panel. From the API, run it explicitly:`,`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$APP`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/floware/v2/workflows/\u003cid>/inference?version=4\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$TOKEN`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type: application/json'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{\"inputs\": [{\"role\": \"user\", \"content\": \"…\"}], \"variables\": {}}'`})]}),`\n`]})})}),`\n`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Promote it.`}),` Console: `,_jsx(_components.strong,{children:`Versions → Promote`}),` on v4. API:`,`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PATCH`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$APP`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/floware/v1/workflow-management/workflows/\u003cid>/current-version?version=4\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$TOKEN`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`]})})}),`\n`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Roll back`}),` if needed by promoting v3 again. Old versions are kept until you delete them.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`in-the-console`,children:`In the console`}),`\n`,_jsx(_components.p,{children:`On an agent or workflow page:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`the `,_jsx(_components.strong,{children:`version selector`}),` (`,_jsx(_components.code,{children:`v3 (current)`}),`) chooses which version you view and test;`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Current: vN`}),` shows which version runs use;`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Versions`}),` lists every version with `,_jsx(_components.strong,{children:`View`}),`, `,_jsx(_components.strong,{children:`Promote`}),` and `,_jsx(_components.strong,{children:`Delete`}),`. The current version cannot be promoted or deleted.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`api`,children:`API`}),`\n`,_jsxs(_components.p,{children:[`The same routes exist for agents (`,_jsx(_components.code,{children:`/floware/v1/agent-management/agents/\u003cid>`}),`) and workflows (`,_jsx(_components.code,{children:`/floware/v1/workflow-management/workflows/\u003cid>`}),`):`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Action`}),_jsx(_components.th,{children:`Request`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Get a version’s YAML`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`GET \u003cbase>?version=\u003cn>`}),` (omit for the current version)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`List versions`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`GET \u003cbase>/versions`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Edit a version in place`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`PUT \u003cbase>?version=\u003cn>`}),` (omit `,_jsx(_components.code,{children:`version`}),` to edit the current one), YAML as `,_jsx(_components.code,{children:`text/plain`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Branch a new version`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`PUT \u003cbase>?create_new_version=true`}),` (from the current version, or from `,_jsx(_components.code,{children:`?version=\u003cn>`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Make a version current`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`PATCH \u003cbase>/current-version?version=\u003cn>`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Delete a version`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DELETE \u003cbase>/versions/\u003cn>`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Run a specific workflow version`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`POST /floware/v2/workflows/\u003cid>/inference?version=\u003cn>`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`versions-and-references`,children:`Versions and references`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`A workflow that references an agent or a sub-workflow `,_jsx(_components.strong,{children:`without`}),` a version (`,_jsx(_components.code,{children:`support/triage`}),`) uses that agent’s `,_jsx(_components.strong,{children:`current`}),` version at run time, so promoting the agent changes the workflow’s behaviour too.`]}),`\n`,_jsxs(_components.li,{children:[`Pin a reference with `,_jsx(_components.code,{children:`@\u003cn>`}),` (`,_jsx(_components.code,{children:`support/triage@3`}),`) when a workflow must not change until you decide.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/wavefront/functions`,children:`Functions`}),` are `,_jsx(_components.strong,{children:`not`}),` versioned: updating one changes every workflow that uses it immediately.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`keeping-versions-in-git`,children:`Keeping versions in git`}),`\n`,_jsxs(_components.p,{children:[`Treat the YAML in the app as a deployment target, not the source of truth: keep agents, workflows and functions in git, and deploy them with a script that saves a new version and promotes it. See `,_jsx(_components.a,{href:`/wavefront/deploy-as-code`,children:`Deploying from git`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Versions","description":"Change agents and workflows safely: save new versions, test them, promote, roll back","icon":"code-compare","href":"/wavefront/versions"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"The two ways to save a change","slug":"the-two-ways-to-save-a-change","depth":2,"children":[]},{"title":"A safe change, step by step","slug":"a-safe-change-step-by-step","depth":2,"children":[]},{"title":"In the console","slug":"in-the-console","depth":2,"children":[]},{"title":"API","slug":"api","depth":2,"children":[]},{"title":"Versions and references","slug":"versions-and-references","depth":2,"children":[]},{"title":"Keeping versions in git","slug":"keeping-versions-in-git","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"rootfloai","siteName":"Wavefront AI | Rootflo","title":"Versions - Wavefront AI | Rootflo","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-21T08:12:26.702Z","originalFileLocation":"wavefront/versions.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Change agents and workflows safely: save new versions, test them, promote, roll back\">\u003cmeta data-mint-head name=\"application-name\" content=\"Wavefront AI | Rootflo\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/rootfloai/vhaXyiJ6Z3XlfH3z/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/rootfloai/vhaXyiJ6Z3XlfH3z/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/rootfloai/vhaXyiJ6Z3XlfH3z/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/rootfloai/vhaXyiJ6Z3XlfH3z/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/rootfloai/vhaXyiJ6Z3XlfH3z/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/rootfloai/vhaXyiJ6Z3XlfH3z/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/rootfloai/vhaXyiJ6Z3XlfH3z/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/rootfloai/vhaXyiJ6Z3XlfH3z/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/rootfloai/vhaXyiJ6Z3XlfH3z/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Versions - Wavefront AI | Rootflo\">\u003cmeta data-mint-head property=\"og:description\" content=\"Change agents and workflows safely: save new versions, test them, promote, roll back\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Wavefront AI | Rootflo\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://wavefront.rootflo.ai/wavefront/versions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://rootfloai.mintlify.site/_mintlify/api/og/v2?division=Workflows\u0026amp;title=Versions\u0026amp;description=Change+agents+and+workflows+safely%3A+save+new+versions%2C+test+them%2C+promote%2C+roll+back\u0026amp;theme=bcaf035d0ae7f9c56e224f26\u0026amp;signature=06db36b5cec868b7a21467be14925bf11b11965b6fe325c635bcdc6f5264ee94\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Versions - Wavefront AI | Rootflo\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Change agents and workflows safely: save new versions, test them, promote, roll back\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://rootfloai.mintlify.site/_mintlify/api/og/v2?division=Workflows\u0026amp;title=Versions\u0026amp;description=Change+agents+and+workflows+safely%3A+save+new+versions%2C+test+them%2C+promote%2C+roll+back\u0026amp;theme=bcaf035d0ae7f9c56e224f26\u0026amp;signature=06db36b5cec868b7a21467be14925bf11b11965b6fe325c635bcdc6f5264ee94\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/rootfloai/vhaXyiJ6Z3XlfH3z/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Wavefront AI | Rootflo\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3B82F6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://wavefront.rootflo.ai/wavefront/versions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/wavefront/versions.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://wavefront.rootflo.ai/#organization\",\"name\":\"Wavefront AI | Rootflo\",\"url\":\"https://wavefront.rootflo.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/rootfloai/AiHxIkh9KtGYiz8E/logo/light.png?fit=max\u0026auto=format\u0026n=AiHxIkh9KtGYiz8E\u0026q=85\u0026s=b493e8fe23f59899d246e2ca32396012\"}},{\"@type\":\"WebSite\",\"@id\":\"https://wavefront.rootflo.ai#website\",\"name\":\"Wavefront AI | Rootflo\",\"url\":\"https://wavefront.rootflo.ai\",\"publisher\":{\"@id\":\"https://wavefront.rootflo.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://wavefront.rootflo.ai/wavefront/versions#webpage\",\"url\":\"https://wavefront.rootflo.ai/wavefront/versions\",\"name\":\"Versions\",\"description\":\"Change agents and workflows safely: save new versions, test them, promote, roll back\",\"dateModified\":\"2026-10-21T08:12:26.702Z\",\"isPartOf\":{\"@id\":\"https://wavefront.rootflo.ai#website\"},\"breadcrumb\":{\"@id\":\"https://wavefront.rootflo.ai/wavefront/versions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://wavefront.rootflo.ai/wavefront/versions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Workflows\",\"item\":\"https://wavefront.rootflo.ai/wavefront/workflows\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Versions\",\"item\":\"https://wavefront.rootflo.ai/wavefront/versions\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://wavefront.rootflo.ai/wavefront/versions#article\",\"headline\":\"Versions\",\"name\":\"Versions\",\"description\":\"Change agents and workflows safely: save new versions, test them, promote, roll back\",\"url\":\"https://wavefront.rootflo.ai/wavefront/versions\",\"mainEntityOfPage\":{\"@id\":\"https://wavefront.rootflo.ai/wavefront/versions#webpage\"},\"dateModified\":\"2026-10-21T08:12:26.702Z\",\"publisher\":{\"@id\":\"https://wavefront.rootflo.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://wavefront.rootflo.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Wavefront AI | Rootflo\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Wavefront AI | Rootflo","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/rootflo/flo-ai"},{"anchor":"Discord","icon":"comments","href":"https://discord.gg/BPXsNwfuRU"}]},"tabs":[{"tab":"Wavefront","groups":[{"group":"Getting started","pages":[{"title":"Project Overview","href":""},{"title":"How Wavefront fits together","icon":"sitemap","href":"/wavefront/overview"},{"title":"Concepts","icon":"book","href":"/wavefront/concepts"},{"title":"Tour of the Wavefront Console","icon":"map","href":"/wavefront/console-tour"},{"title":"Quickstart","icon":"rocket","href":"/wavefront/quickstart"}]},{"group":"Models and agents","pages":[{"title":"LLM Repository","icon":"brain","href":"/wavefront/llm-configs"},{"title":"Agents","icon":"robot","href":"/wavefront/agents"},{"title":"Structured output","icon":"brackets-curly","href":"/wavefront/structured-output"},{"title":"Tools","icon":"wrench","href":"/wavefront/tools"},{"title":"Images, documents and video","icon":"photo-film","href":"/wavefront/media"}]},{"group":"Workflows","pages":[{"title":"Workflows","icon":"diagram-project","href":"/wavefront/workflows"},{"title":"How a workflow runs","icon":"list-ol","href":"/wavefront/workflow-execution-model"},{"title":"Passing data between nodes","icon":"arrow-right-arrow-left","href":"/wavefront/workflow-data-flow"},{"title":"Sub-workflows","icon":"layer-group","href":"/wavefront/sub-workflows"},{"title":"Routing and iteration","icon":"code-branch","href":"/wavefront/routing-and-iteration"},{"title":"Function nodes","description":"Built-in workflow steps: queries, inserts, file downloads, configurations, your functions, API calls, email","icon":"cubes","href":"/wavefront/function-nodes"},{"title":"Versions","icon":"code-compare","href":"/wavefront/versions"}]},{"group":"Functions","pages":[{"title":"Functions","description":"Small JavaScript steps for the exact parts of a workflow: computing, comparing, deciding, reshaping","icon":"function","href":"/wavefront/functions"}]},{"group":"Data, files and configuration","pages":[{"title":"Datasources","icon":"database","href":"/wavefront/datasources"},{"title":"Dynamic queries","icon":"magnifying-glass","href":"/wavefront/dynamic-queries"},{"title":"File storage","icon":"folder-open","href":"/wavefront/file-storage"},{"title":"Configurations","icon":"sliders","href":"/wavefront/configurations"},{"title":"Audit trail","icon":"clipboard-list","href":"/wavefront/audit-trail"}]},{"group":"Run and integrate","pages":[{"title":"Running workflows","icon":"play","href":"/wavefront/running-workflows"},{"title":"Integrating an application","icon":"plug","href":"/wavefront/integrating-an-app"},{"title":"Users and access","icon":"users","href":"/wavefront/users-and-access"},{"title":"Chatbots","icon":"comments","href":"/wavefront/chatbots"},{"title":"Deploying from git","icon":"code-branch","href":"/wavefront/deploy-as-code"}]},{"group":"Guides","pages":[{"title":"Guide: verify a document against submitted data","icon":"file-circle-check","href":"/guides/document-verification"},{"title":"Guide: configurable rules and scoring","icon":"scale-balanced","href":"/guides/rules-and-scoring"},{"title":"Guide: a chat assistant beside a record","icon":"message-bot","href":"/guides/record-chat-assistant"},{"title":"Guide: a review dashboard and work lists","icon":"chart-column","href":"/guides/review-dashboard"}]},{"group":"Patterns and troubleshooting","pages":[{"title":"Patterns and best practices","icon":"lightbulb","href":"/wavefront/patterns"},{"title":"Troubleshooting","icon":"bug","href":"/wavefront/troubleshooting"}]},{"group":"Operations","pages":[{"title":"Architecture","icon":"server","href":"/operations/architecture"},{"title":"Environment and configuration","icon":"gear","href":"/operations/environment"},{"title":"Running several apps","icon":"boxes-stacked","href":"/operations/multi-app"},{"title":"Upgrades","icon":"arrow-up-right-dots","href":"/operations/upgrades"}]}]},{"tab":"FloAI","pages":[{"title":"FloAI","href":"/flo-ai"}]}]},"basePath":"","title":"Versions - Wavefront AI | Rootflo","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":[],"chunks":[]}