Skip to main content
Once you’ve built and saved a workflow, you can run it from the editor or the workflows list. Each run creates an independent execution with its own status, logs, and output.

Starting a run

Two ways to start:
  1. From the editor: Click the Run button (play icon) in the header bar. The editor saves your workflow first.
  2. From the workflows list: Click the play icon on the workflow’s row.
Both take you to the parameters page where you fill in runtime values before the run starts.

Filling in parameters

The parameters page shows all workflow parameters defined in the editor. Fill in a value for each one, or leave them at their defaults. Parameters without defaults must be filled in before running.

Run settings

Below the parameters, you can configure settings for this specific run:
SettingDescription
Proxy LocationRoute browser traffic through a proxy in a specific country. Default: US Residential.
Webhook Callback URLURL that receives a POST request when the run completes
Max Screenshot ScrollsOverride screenshot scroll depth for this run
Extra HTTP HeadersCustom headers included in all browser requests (JSON)
CDP AddressConnect to your own browser for local development

Monitoring a run

After clicking Run, you’re taken to the live execution view, the same interface described in Watching Live Execution. For workflows, the left panel also shows a block timeline: a list of all blocks in the workflow. Completed blocks show a checkmark. The currently executing block is highlighted. Workflow run block timeline

Run statuses

StatusDescription
createdRun initialized
queuedWaiting for an available browser
runningBlocks are executing
completedAll blocks finished successfully
failedA block failed and the workflow stopped
canceledYou canceled the run
timed_outThe run exceeded its time limit
terminatedThe run was terminated by the system

Viewing results

After a run completes, open it from Runs in the sidebar. The run detail page shows:
  • Block-by-block results: Each block’s output, status, and execution time
  • Recording: Full video replay of the browser session
  • Parameters: The values you submitted for this run
See Reviewing results for details on the Actions, Recording, Parameters, and Diagnostics tabs.

Canceling a run

Click the Cancel button during execution. A confirmation dialog appears. The run moves to canceled status and any configured webhook fires.

Run history

Access past runs from two places:
  1. Runs in the left sidebar: shows all runs across all workflows
  2. History button (clock icon) in the workflow editor: shows runs for this specific workflow

What’s next

Build a Workflow

Create and edit workflows in the visual editor

Block Reference

Configuration fields for every block type