Manually running a workflow - GitHub Docs (original) (raw)

When a workflow is configured to run on the workflow_dispatch event, you can run the workflow using the Actions tab on GitHub, GitHub CLI, or the REST API.

Configuring a workflow to run manually

To run a workflow manually, the workflow must be configured to run on the workflow_dispatch event.

To trigger the workflow_dispatch event, your workflow must be in the default branch. For more information about configuring the workflow_dispatch event, see Events that trigger workflows.

Write access to the repository is required to perform these steps.

Running a workflow

Running a workflow using the REST API

When using the REST API, you configure the inputs and ref as request body parameters. If the inputs are omitted, the default values defined in the workflow file are used.

Note

You can define up to 25 inputs for a workflow_dispatch event.

For more information about using the REST API, see REST API endpoints for workflows.