Documentation
HomeAPISign In
  • Getting Started
    • Overview
      • Core Concepts
      • Building your First Workflow
    • API Reference
  • Your Data
    • Brand Kits
    • Knowledge Bases
      • Add Data
        • Upload Files
        • Web Scrape
        • Import from Google Drive
        • Import from SQL Database
        • Import from Shopify
      • Knowledge Base Search
      • Knowledge Base Metadata
      • Knowledge Base API
  • Building Workflows
    • Workflow Concepts
      • Workflow Inputs
        • Input Types
      • Workflow Outputs
      • Variable Referencing
      • Liquid Templating
    • Workflow Steps
      • AI
        • Prompt LLM
          • Model Selection Guide
          • Prompting Guide
        • Transcribe Audio File
      • Web Research
        • Google Search
        • Web Page Scrape
      • Code
        • Run Code
        • Call API
        • Format JSON
        • Run SQL Query
        • Write Liquid Text
      • Flow
        • Condition
        • Iteration
        • Human Review
        • Content Comparison
        • Error
      • Data
        • Read from Grid
        • Write to Grid
        • Search Knowledge Base
        • Write to Knowledge Base
        • Get Knowledge Base File
      • AirOps
        • Workflow
        • Agent
      • Image & Video
        • Generate Image with API
        • Search Stock Images
        • Fetch Stock Image with ID
        • Resize Image
        • Screenshot from URL
        • Create OpenGraph Image
        • Create Video Avatar
      • SEO Research
        • Semrush
        • Data4SEO
      • Content Quality
        • Detect AI Content
        • Scan Content for Plagiarism
      • Content Processing
        • Convert Markdown to HTML
        • Convert PDF URL to Text
        • Group Keywords into Clusters
      • B2B Enrichment
        • Hunter.io
        • People Data Labs
      • CMS Integrations
        • Webflow
        • WordPress
        • Shopify
        • Contentful
        • Sanity
        • Strapi
      • Analytics Integrations
        • Google Search Console
      • Collaboration Integrations
        • Gmail
        • Google Docs
        • Google Sheets
        • Notion
        • Slack
    • Testing and Iteration
    • Publishing and Versioning
  • Running Workflows
    • Run Once
    • Run in Bulk (Grid)
    • Run via API
    • Run via Trigger
      • Incoming Webhook Trigger
      • Zapier
    • Run on a Schedule
    • Error Handling
  • Grids
    • Create a Grid
      • Import from Webflow
      • Import from Wordpress
      • Import from Semrush
      • Import from Google Search Console
    • Add Columns in the Grid
    • Run Workflows in the Grid
      • Add Workflow Column
      • Run Workflow Column
      • Map Workflow Outputs
      • Review Workflow Run Metadata
    • Review Content in the Grid
      • Review Markdown Content
      • Review HTML Content
      • Compare Content Difference
    • Publish to CMS from Grid
    • Pull Analytics in the Grid
    • Export as CSV
  • Copilot
    • Chat with Copilot
    • Edit Workflows with Copilot
    • Fix Errors with Copilot
  • Monitoring
    • Task Usage
    • Analytics
    • Alerts
    • Execution History
  • Your Workspace
    • Create a Workspace
    • Folders
    • Settings
    • Billing
    • Use your own LLM API Keys
    • Secrets
    • Team and Permissions
  • Chat Agents (Legacy)
    • Agent Quick Start
    • Chat Agents
    • Integrate Agents
      • Widget
      • Client Web SDK
  • About
    • Ethical AI and IP Production
    • Principles
    • Security and Compliance
Powered by GitBook
On this page
  • What is the difference between a draft, a version, and a default version?
  • How do I create a new version?
  • What happens to my previous version if I publish again?
  • Utilizing Previous Versions
  • Restoring previous versions as a draft
  • Set previous versions as the Default Version
  • Referencing Versions through the API

Was this helpful?

  1. Building Workflows

Publishing and Versioning

Track changes and productionize apps with versions

Last updated 2 months ago

Was this helpful?

Versioning allows you to easily manage historic instances, drafts, and published default versions of your Workflows.

What is the difference between a draft, a version, and a default version?

  1. Drafts are not saved permanently, and only the latest draft is saved.

  2. Versions on the other hand are permanently saved. They can always be viewed and restored. You can also run versions of Workflows as a batch, API, or add them to another workflow or agent

  3. The Default Version is the version of the Workflow that:

    1. Users interact with in the AirOps UI

    2. Runs when you call the Execute POST endpoint, unless another version is passed in as a parameter

How do I create a new version?

When you're ready to share, integrate, or run your Workflow, publish it into a permanent version by clicking "Publish Workflow" in the top right-hand corner:

This generates "Version 1" of your Workflow, which now acts as the Default Version.

What happens to my previous version if I publish again?

All previously published versions are permanently saved, and a new version becomes the Default version.

Utilizing Previous Versions

To view the previous versions of your Workflow, simply click on the "Versions" dropdown and select the desired version:

Your draft will NOT be overwritten by simply clicking on a previous version.

Restoring previous versions as a draft

To restore a previous version to your current draft, start by selecting your desired historical version from the dropdown, then hitting "Restore."

Your current draft WILL be overwritten by clicking "Restore," so be sure you don't have any changes that could be lost.

This promotes your historic version into the current draft, which you can then choose to save or publish.

Set previous versions as the Default Version

To restore a previous version to be your Default Version, start again by selecting your desired historical version from the dropdown, then hitting "Set Default."

When you change the default version, only the version in production is changed. The latest draft does NOT change.

Referencing Versions through the API

Once you have multiple versions of your Workflow, you can specify which specific version to execute via the AirOps API.

To do this, navigate back to the display window of your Workflow, and click on the "Integrate" tab at the top:

The general POST command will always run against the Default Version, while the Versioning endpoint allows you to specify the desired version to execute.