# gh workflow run

Kick off an Actions workflow on demand.

## Quick answer
```
gh workflow run deploy.yml
```

## Syntax
```
gh workflow run [<workflow-id> | <workflow-name> | <filename>] [flags]
```

## Examples

# Run a workflow by filename
gh workflow run deploy.yml

# Run on a specific branch
gh workflow run deploy.yml --ref release-2.0

# Pass inputs to the workflow
gh workflow run deploy.yml -f environment=prod -f version=1.4.0

# Provide inputs as JSON on stdin
echo '{"environment":"prod"}' | gh workflow run deploy.yml --json

# Pick interactively from a list
gh workflow run

## Key flags

  -r, --ref	The branch or tag to run the workflow on.
  -f, --raw-field	Set a string input (key=value).
  -F, --field	Set a typed input (numbers, booleans, @file).
  --json	Read workflow inputs as JSON from standard input.

Full guide: https://ghcli.com/gh-workflow-run.php