List GitHub workflow runs

github.listWorkflowRuns lists runs across a repository or for one workflow.

automations/list-failed-github-runs.automation.ts

import { automation } from "automate.ax"
import { github } from "automate.ax/github"

export default automation("List failed GitHub runs", () => {
  const runs = github.listWorkflowRuns({
    branch: "main",
    owner: "SentsCo",
    repository: "automate.ax",
    status: "failure",
    workflowId: "ci.yml",
  })
})

Provide owner and repository. Optional filters are workflowId, actor, branch, checkSuiteId, created, event, headSha, status, and excludePullRequests. created uses GitHub date-search syntax. Pagination defaults to page 1 with 30 results. Returns each run’s id, html_url, status, and conclusion. Requires Actions read permission.

Built-in triggers

Built-in actions

Runtime utilities

Integrations

List GitHub workflow runs