Skip to main content

Update Workflows

Overview​

When a new template revision is available, you can update your workflow to use it. A notification appears in the Workflow Settings tab when newer revisions are available.

Check for available revisions​

StackGuardian notifies you when a new revision of your workflow is available:

  1. Navigate to your workflow's Workflow Settings tab

  2. Look for the Workflow Revision indicator in the top-right corner

  3. If a newer revision exists, you'll see "New Revision Available"

    Check for available revisions

    Check for available revisions

Update a workflow revision​

Step 1: Revision​

  1. Click New Revision Available in the Workflow Revision indicator
  2. Review the available revisions:
    • Alias Name - The revision identifier
    • Revision Notes - Changes included in this revision
    • Published Revision - Status badge
    • Current Revision - Your current version
  3. To view all available revisions including previous versions, click Show all Revisions
  4. Select the revision you want to use
  5. Expand the revision to view details:
    • Configuration changes
    • Dependency updates
    • Breaking changes
Revision details

Revision details

Choose update behavior​

Select how to handle advanced settings when updating. Advanced settings include template logic and workflow configuration but do not include variables, parameters, connectors, or environment variables (which you'll configure in the following steps).

Update Advanced Settings

  • Uses the selected revision's advanced settings (template logic and workflow configuration)
  • Your current variables, parameters, connectors, and environment variables remain reviewable in the following steps

Keep Current Advanced Settings

  • Keeps your current advanced settings from your existing workflow
  • Variables, parameters, connectors, and environment variables remain reviewable in the following steps
info

Advanced settings details are not shown during the update process. Navigate to the template revision to review specific advanced settings before making your selection.

Step 2: Connectors​

Review and update connectors for the workflow. The system detects changes automatically by comparing your current workflow with the selected revision.

  1. Select a workflow tab to view its deployment environment
  2. Review detected changes indicated by status badges:
    • Unmodified - No changes were made
    • Updated - Connector configuration modified in selected revision
    • Added - New workflow added in selected revision
    • Removed - Workflow removed in selected revision (appears disabled)
  3. For the workflow:
    • Select or update the Connector
    • Configure Child Integrations if required
    • Add or modify Environment Variables
Review and update connectors

Review and update connectors

How values are updated​

When updating connectors and environment variables:

  • Existing variables - Your current values are preserved
  • New variables - Added from the selected revision
  • Deleted variables - Retained in your workflow even if removed from the selected revision

Step 3: Template parameters​

Configure parameters for the workflow if changes are detected. The system automatically merges your existing configuration with any new parameters from the selected revision.

  1. Review workflows marked with status badges
  2. Fill in required template parameters for the workflow
  3. Use Reset to Defaults to replace all values with defaults from the selected revision
  4. Reference existing values using Update Reference when available
Configure parameters for workflows

Configure parameters for workflows

How values are updated​

When updating template parameters:

  • Existing parameters – Your current values are preserved
  • New parameters – Added from the selected revision
  • Deleted parameters – Retained in your workflow even if removed from the selected revision

The Reset to Defaults button replaces all parameter values with the defaults defined in the selected revision's template.

What happens after updating​

After completing the update:

  1. Your workflow updates to the selected revision
  2. Advanced settings update based on your chosen behavior
  3. Configuration values are merged: Existing values are preserved New parameters use defaults from the selected revision Deleted parameters are retained
  4. A success notification confirms the update
  5. You can run the workflow to apply changes
After completing the update

After completing the update