View workflow version history

Review your workflow's version history to see all past saves, compare versions, and identify when changes were made.

Before you begin

  • A workflow with at least one saved version.
  • You have permission to manage workflows in the project.

Procedure

  1. Open the workflow in the workflow builder.
  2. Click the Version history icon in the toolbar to open the version history panel.
  3. Review the version list, which is grouped by date with the newest versions first.

    Each entry shows the version number, status badge (published or previously published), timestamp, and the user who created it.

  4. Use the status filter at the top of the panel to show only published or previously published versions.
  5. To view a specific version, click its entry in the list.

    The workflow builder displays the steps, connections, and configuration for that version.

  6. To take action on a version, click the options menu () on its entry.

    You can restore the version, edit its name and description, or export it as a JSON file.

  7. To list versions by using the API, send a GET request:
    $ curl -X GET \
        "${AO_URL}/api/v1/workflows/${WORKFLOW_ID}/versions" \
        -H "Authorization: Bearer ${TOKEN}"

Results

  • The version history panel lists all saved versions grouped by date.
  • Each version entry shows the version number, status badge, timestamp, and creator.
  • Clicking a version entry displays the workflow definition for that version on the canvas.