Skip to content

Start-GitHubWorkflow: Return run ID and URLs, add -OpenBrowser switch #641

Description

Context: When triggering a workflow dispatch via Start-GitHubWorkflow, the function currently does not return the triggered workflow run object, run ID, or URLs. The GitHub Actions REST API (https://docs.github.com/en/enterprise-cloud@latest/rest/actions/workflows?apiVersion=2026-03-10#create-a-workflow-dispatch-event) returns a 204 No Content response on success, but the run is accessible and should be retrievable.

Request: Enhance Start-GitHubWorkflow to return the workflow run object and add a -OpenBrowser switch.

Desired capability:

  • Start-GitHubWorkflow returns a run object with id, html_url, status, created_at, name
  • -OpenBrowser switch opens the html_url in the default browser

Acceptance criteria:

  • Returns a run object matching the GitHub Actions API workflow run schema
  • -OpenBrowser switch opens the html_url via Start-Process
  • No breaking changes to existing behavior
  • Works with both GitHub.com and GitHub Enterprise Server

Related: https://docs.github.com/en/enterprise-cloud@latest/rest/actions/workflows?apiVersion=2026-03-10#create-a-workflow-dispatch-event

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions