Skip to Content
PetavueHelp Center
Workflows

Understanding Workflows

Every dashboard or report you publish in Petavue is powered by a workflow. It holds the steps that collect your data, work out the numbers, and publish the result, and it reruns those steps whenever your data changes.

What Is a Workflow?

A workflow is the set of steps Petavue runs to collect data, transform it, calculate metrics, and publish the results. Think of it as a recipe: once it's verified, Petavue follows the same recipe on every run, with fresh data each time.

A workflow can produce a dashboard, a published data file such as a CSV, or a Data Summary. It can also act on its results, for example by emailing them, posting them to Slack, or writing values back to HubSpot.

Where a Workflow Comes From

You create a workflow when you publish work from a Sage chat. Select Verify & Publish, and publishing takes you through three steps:

  1. Workflow: the steps that build your numbers.
  2. Outputs: what to publish. Each output has its own card, so you turn on the ones you want, such as the dashboard or file.
  3. Schedule: when the workflow runs on its own.
The Schedule step of Verify and Publish, asking how often this should run with One time and Recurring options, Recurring selected with Every data sync, above a step bar reading Workflow, Outputs, Schedule
Publishing takes your chat's work through Workflow, Outputs, and Schedule

For the full publishing walkthrough, see Building a Dashboard.

How It Works

Each run follows the same five stages:

  1. Retrieve the data from your connected sources.
  2. Transform it into the shape the analysis needs.
  3. Calculate the metrics and insights.
  4. Build the output, such as each widget on a dashboard.
  5. Publish the result.

Why You Can Trust It

Before a workflow is published, it goes through two reviews: a User Review, where you check the steps, and an Agentic Review, which checks that the workflow can run on its own. A workflow can also be built on the outputs of your other workflows, including ones shared with you. See Building on Other Workflows.

Once published, the workflow is saved as a fixed definition. Every run follows the same logic on new data, so the numbers stay consistent from one run to the next.

The Workflow Page

Open a workflow from your Workflows list. The Overview tab shows How this workflow runs, read top to bottom, with each stage starting when the one above it finishes:

  • Trigger: what starts a run, such as every data sync.
  • Prepare: the queries, code, and files that build the workflow's data.
  • Action: what the workflow does with the data, such as publishing a dashboard.

Beside the flow, cards show the workflow's schedule, its latest run, and its details, such as its owner and when it was created.

The Overview tab of a workflow, showing How this workflow runs from a Trigger of every data sync, to a Prepare stage listing its database queries, files and code step with all steps passed, to an Action stage that publishes a dashboard successfully
The Overview tab shows how a workflow runs

Viewing Step Details

Select View steps under Prepare to see each step in order. Open a step to see what it does: its instructions and conditions, the code or query it runs, the output it produces, and whether it's verified.

Step details are read-only. To change a step, select Edit in Source Session and ask Sage in the chat.

A step opened from a workflow, showing its instructions, the query it runs, and the file it outputs, with the step marked Success
Each step shows exactly how it works

Workflow Settings

The top of the workflow page holds the controls you'll use most:

  • The workflow's status, such as Active, with Pause to stop scheduled runs and Run now to run it yourself.
  • Source Session, which opens the chat the workflow was built in.
  • View Dashboard, which opens what the workflow publishes.
  • Share with team, which lets your teammates view the workflow and its runs.

The Settings tab holds everything else: the workflow's name and description, its schedule, sharing, and the options to pause or delete it. See Workflow Settings and Failure Alerts.

The top of a workflow page with its name, Source Session, View Dashboard and Manage Recommendations buttons and a Share with team toggle, above the Overview, Runs and Settings tabs with Settings open
The workflow's main controls sit at the top of its page

Editing a Workflow

To change a workflow, select Source Session and ask Sage for the change in the chat. Then publish again.

Only you can change a workflow you created. Teammates you share it with can view it and its runs.

Running a Workflow

Select Run now to run the workflow straight away and republish its results with the latest data.

Some workflows are one-time snapshots, labeled next to their name. A snapshot never refreshes, so Run now isn't available.

Runs

The Runs tab lists every run, with its status, how it was started, how long it took, and when it ran. Expand a run to see each step's status and output. If a run failed, expanding it shows which step failed.

If a scheduled run fails, Petavue tries it again up to three more times. If it still fails, the workflow's creator gets an email.

The Runs tab with two successful runs, one labeled manual and one labeled initial, with the manual run expanded to show each step, its status, how long it took, and the file it produced
Expand a run to trace each step

One Workflow, Many Outputs

A single workflow can publish more than one output from the same verified run, such as a dashboard and a Data Summary, so they always agree. It can also send results by email or Slack, or write them back to HubSpot. See Writing Workflow Results to HubSpot.

Running on a Schedule

You set the schedule when you publish, and you can change it at any time in Settings > Schedule:

  • Manual refresh only: runs only when you select Run now.
  • Every data sync: refreshes whenever new data arrives.
  • Custom schedule: runs at a frequency and time you pick.

Each scheduled run saves a snapshot to your History Folder.

Keep in Mind

The steps are read-only here. Changes happen in the source session, with Sage.

Sharing is view-only. Teammates can see a shared workflow and its runs. Only you can change it.

Failed runs stay visible. Every run, including failed ones, stays on the Runs tab, so you can always trace what happened.

Getting Help

If you have questions, run into issues, or want to share feedback on the experience, reach out to us directly at support@petavue.com. We're available and responsive, and your input matters.

Petavue · What's New · November 6, 2026

On this page