Skip to content
Latchkey

act workflow_dispatch inputs missing running Actions locally

On GitHub you supply workflow_dispatch inputs through the UI or API. act does not prompt for them, so inputs.* is empty unless you trigger the workflow_dispatch event and pass values with --input or an event JSON file.

What this error means

A step reads inputs.version (or similar) as empty and fails or uses a default, because no dispatch input was provided to act.

act
Error: Input 'version' is required but was empty
| inputs.version resolved to an empty string

Common causes

The workflow_dispatch event was not triggered

Running act with the default push event never populates dispatch inputs at all.

No input values were supplied

Even on workflow_dispatch, act leaves inputs empty unless you pass --input or an event payload file.

How to fix it

Trigger dispatch with inputs

Run the workflow_dispatch event and pass each input value.

Terminal
act workflow_dispatch --input version=1.2.3 -j release

Provide an event payload file

Supply a JSON payload with the inputs under inputs and pass it with -e.

Terminal
act workflow_dispatch -e event.json

How to prevent it

  • Trigger the workflow_dispatch event explicitly with act.
  • Pass required inputs with --input or an event payload file.
  • Set sensible defaults so missing local inputs do not break the run.

Related guides

Tired of flaky CI? Latchkey auto-heals failed jobs and retries them for you. Start free →