---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://sourcecraft.dev/portal/docs/en/cli-ref/src-run-trigger.md
  - https://sourcecraft.dev/portal/docs/ru/cli-ref/src-run-trigger.md
---
> **Documentation Index:** Fetch the complete configuration index at https://sourcecraft.dev/portal/docs/en/llms.txt

# src run trigger

Trigger a specific CI workflow by name with optional input parameters.

The workflow will run on the current branch/HEAD by default, or you can specify
a different commit, branch (ref), or tag to run on.

You can also specify where to read the CI configuration from using the --cfg-*
flags. This is useful for testing experimental CI configurations.

## Usage

`src run trigger <workflow_name> [param=value ...] [flags]`

### Examples

**Trigger pytest workflow on current branch**

`src run trigger pytest`

**Trigger with parameters**

`src run trigger pytest param=value param2=value2`

**Trigger on a specific commit**

`src run trigger pytest --commit abc1234`

**Trigger on a specific branch**

`src run trigger pytest --ref mybranch`

**Trigger on a specific tag**

`src run trigger pytest --tag v1.0.0`

**Use config from a specific commit**

`src run trigger pytest --cfg-commit abc1234`

**Use config from an experimental branch**

`src run trigger pytest --cfg-ref myexperimental-cicd`

**Use config from a specific tag**

`src run trigger pytest --cfg-tag v1.0.0`

**Combine: run on tag with config from experimental branch**

`src run trigger pytest --tag v1.0.0 --cfg-ref experimental-ci`

### Flags

| Flag | Description |
| --- | --- |
| `--commit string` | Run workflow on specific commit |
| `--ref string` | Run workflow on specific branch |
| `--tag string` | Run workflow on specific tag |
| `--cfg-commit string` | Read CI config from specific commit |
| `--cfg-ref string` | Read CI config from specific branch |
| `--cfg-tag string` | Read CI config from specific tag |
| `--shared` | Run shared workflows (for users without repository access) |
| `-w, --web` | Open the triggered run in browser |

### Inherited flags

| Flag | Description |
| --- | --- |
| `--env string` | Override Sourcecraft environment (use 'src envs' to list available) |
| `--json string` | Output JSON, optionally filtered (--json or --json=field1,field2) |
| `--json-compact string` | Output compact JSON, optionally filtered |
| `-R, --repo string` | Select another repository using OWNER/REPO format |
| `-V, --verbose` | Enable debug logging output |

### Learn more

Use `src run trigger <subcommand> --help` for more information about a command.