# pw workflows run

> Source: https://parallelworks.com/docs/cli/pw/workflows/run

## pw workflows run

Run a saved workflow or a local YAML file

```
pw workflows run <name-or-file> [flags]
```

### Examples

```
  # Run a saved workflow by name
  pw workflows run my-workflow
  
  # Run a marketplace workflow by slug
  pw workflows run marketplace/my-marketplace-item
  
  # Run a workflow from a local YAML file
  pw workflows run ./my-workflow.yaml
  
  # Run with input parameters
  pw workflows run -i '{"param1": "value1"}' my-workflow
  
  # Run with inputs from a JSON file
  pw workflows run -i inputs.json my-workflow
  
  # Run with saved inputs
  pw workflows run --saved-inputs my-inputs my-workflow
  
  # Run with saved inputs, overriding individual values from --inputs
  pw workflows run --saved-inputs my-inputs -i '{"param1": "value1"}' my-workflow
  
  # Validate workflow without executing (dry run)
  pw workflows run --dry-run my-workflow
  
  # Run with a custom display name
  pw workflows run --name "Test run with new params" my-workflow
  
  # Output as JSON
  pw workflows run -o json my-workflow
```

### Options

```
      --dry-run               Validate only, don't execute
  -h, --help                  help for run
  -i, --inputs string         JSON string or file path with input values
      --name string           Custom display name for the run
  -o, --output string         Output format (interactive, json, text) (default "interactive")
      --saved-inputs string   Name of saved inputs on the workflow to load input values from (overridden by --inputs)
```

### Options inherited from parent commands

```
      --context string         The context to use. Overrides PW_CONTEXT environment variable and current context from config.
      --platform-host string   The Parallel Works ACTIVATE platform host to use. Will override any other platform host settings.
  -v, --verbose                Enable verbose logging
```

### SEE ALSO

* [pw workflows](/docs/cli/pw/workflows)	 - Manage workflows