Skip to content

Versions

The Versions section provides controls for creating, managing, and maintaining workflow tool versions. Versions help you track changes, ensure reliability, and deploy stable configurations.

Each version is an immutable snapshot that includes the tool name and description, flow canvas, guardrails, and environment variables at the time it is created.

Create a Tool Version

  1. Open the workflow tool and select Versions in the left navigation.
  2. Choose New Version, enter details, review the summary, and confirm.

Rules:

  • The workflow draft cannot be versioned if the canvas contains errors.
  • Versions cannot be modified after creation.
  • Snapshots are always created from the current draft.

Manage Versions

The Versions list displays all existing versions of a workflow tool, including their name, description, guardrails and environment variables, deployment status, and creation details.

The Status column is displayed only for App-scoped workflow tools; not for tools in the Tools Library.

Action Description
Preview Version Displays a read-only summary of the version’s core components, including the flow, guardrails, and environment variables.
Go to Flow Opens the versioned flow in the canvas in read-only mode.
Endpoint Displays the API endpoint associated with the version and allows selecting the execution mode (synchronous or asynchronous).

Available only for workflow tools in the Tools Library; not shown for app-scoped workflow tools.
Restore Version Replaces the current draft with the selected version after confirmation. The restored version becomes the active draft.
Delete Version Removes the version after confirmation.

When you create a version, its endpoint becomes active; if the version is deleted, the endpoint is disabled and any calls to that endpoint will fail.

For more information about workflow tool versions and app versions, see Workflow tools and App versioning.

Manage Endpoint

The Endpoint section is accessed from Versions → View Endpoint. Endpoint settings define how external applications call the workflow tool and how each version is exposed as an API.

When a version is created, the tool is deployed and the Sync and Async poll endpoints are generated.

If you want to generate an Async push endpoint for the tool, do the following:

  1. Click the Async push tab and click Enable/Settings.

  2. The Sync/Async mode setup pop-up displays with sync mode disabled by default.

    • Synchronous mode timeout. The allowed range is 60 to 300 seconds (5 minutes). The default is 180 Seconds (3 minutes). The endpoint will trigger a timeout error if the request is not completed within the selected time frame.

    • Asynchronous mode configuration: Turn on the Enable async toggle and do the following:

      1. Provide the URL of your external application to which messages are to be delivered.
      2. Enter the access token generated by the external application.
      3. Set the Asynchronous mode timeout duration:
      4. Set timeout: The allowed timeout range is 60 seconds to 600 seconds (10 minutes). The default is 180 Seconds (3 minutes).
      5. No timeout: This allows the tool to process the request without a time limit.
        Async Mode Configuration

    Note

    Timeout precedence: Tool timeout > Node timeout > Model timeout.

  3. Click Save. The async push endpoint is created.