GH-WORKFLOW-RUN(1)             GitHub CLI manual            GH-WORKFLOW-RUN(1)



<?><?><?> (NAME)
       gh-workflow-run - <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?> workflow_dispatch



<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       gh workflow run [<workflow-id> | <workflow-name>] [flags]



<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> workflow_dispatch
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>.


       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> GitHub Actions <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?> on.workflow_dispatch
       <?><?><?><?><?><?><?><?> <?><?><?>.


       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?>:

       o <?><?><?><?><?><?><?> <?><?><?><?><?><?>

       o <?><?> <?><?><?><?> <?><?><?><?><?><?><?> -f/--raw-field <?><?>
         -F/--field

       o <?><?><?><?><?><?><?> JSON<?> <?><?> <?><?><?><?> <?><?><?><?><?>
         <?><?><?><?><?><?><?><?><?>


       <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> (URL) <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>.



<?><?><?><?><?><?><?><?> (OPTIONS)
       -F, --field <key=value>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> key=value<?> <?><?>
              <?><?><?><?><?> <?><?><?> @ (<?><?> "gh help api"
              <?><?><?><?><?><?> <?><?><?><?>).


       --json <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> JSON <?><?>
              <?><?><?><?> STDIN


       -f, --raw-field <key=value>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> key=value


       -r, --ref <string>
              <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> (tag) <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>



<?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> (OPTIONS INHERITED FROM PARENT
       COMMANDS)
       -R, --repo <[HOST/]OWNER/REPO>
              <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> [HOST/]OWNER/REPO



<?><?><?><?><?> <?><?><?><?> (EXIT CODES)
       0: <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>


       1: <?><?><?>


       2: <?><?><?><?><?> <?><?><?> <?><?>


       4: <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>


       <?><?><?><?>: <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?>.



<?><?><?><?><?><?><?> (EXAMPLES)
       # <?><?><?><?><?><?><?> gh <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       $ gh workflow run

       # <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> 'triage.yml' <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       $ gh workflow run triage.yml

       # <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> 'triage.yml' <?><?> <?><?> <?><?><?><?> (ref) <?><?><?><?>
       $ gh workflow run triage.yml --ref my-branch

       # <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> 'triage.yml' <?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       $ gh workflow run triage.yml -f name=scully -f greeting=hello

       # <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> 'triage.yml' <?><?> JSON <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       $ echo '{"name":"scully", "greeting":"hello"}' | gh workflow run triage.yml --json




<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       gh-workflow(1)

                                   Sep 2026                 GH-WORKFLOW-RUN(1)