Skip to main content

Run a workflow

Run accepts an optional YAML workflow path. Without one, it loads the bundled empty sample workflow. It requires a verified local Paxter registration. Registered access allows up to 10 workflow actions; larger workflows require a current subscription.

paxter run path\to\workflow.yaml

Workflow structure​

Headless: true
NeedVideo: false
Actions:
  - Do: Page_GotoAsync
    Data1: https://your-test-environment.example

Headless controls whether the browser window is shown. NeedVideo enables Playwright video capture. After a run, Paxter writes an HTML report and output.json to the configured output path.

Parallel runs​

Parallel execution is a paid capability. Set MaxParallelTests and TestIterations in paxter.yaml, then use runparallel:

paxter runparallel path\to\workflow.yaml

At least one of MaxParallelTests and TestIterations must be greater than 1. The standard run command rejects parallel settings. Paxter limits parallel execution to 20 workers and iterations to 100. Parallel reports are written below the configured temporary path.

Exit behaviour​

An action failure is recorded in the report and stops the remaining actions in that workflow. Inspect the generated report for the failed action and captured evidence.