GitHub Actions

GitHub Actions Workflow Runs API

Manage and monitor workflow run executions

GitHub OpenAPI
Business capability
Continuous Integration Management BC-4210.10

Operations 17

GET /repos/{owner}/{repo}/actions/runs Github Actions List Workflow Runs for a Repository #
GET /repos/{owner}/{repo}/actions/runs/{run_id} Github Actions Get a Workflow Run #
DELETE /repos/{owner}/{repo}/actions/runs/{run_id} Github Actions Delete a Workflow Run #
POST /repos/{owner}/{repo}/actions/runs/{run_id}/approve Github Actions Approve a Workflow Run for a Fork Pull Request #
GET /repos/{owner}/{repo}/actions/runs/{run_id}/approvals Github Actions Get the Review History for a Workflow Run #
GET /repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number} Github Actions Get a Workflow Run Attempt #
GET /repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}/logs Github Actions Download Workflow Run Attempt Logs #
POST /repos/{owner}/{repo}/actions/runs/{run_id}/cancel Github Actions Cancel a Workflow Run #
POST /repos/{owner}/{repo}/actions/runs/{run_id}/deployment_protection_rule Github Actions Review Custom Deployment Protection Rules for a Workflow Run #
POST /repos/{owner}/{repo}/actions/runs/{run_id}/force-cancel Github Actions Force Cancel a Workflow Run #
GET /repos/{owner}/{repo}/actions/runs/{run_id}/logs Github Actions Download Workflow Run Logs #
DELETE /repos/{owner}/{repo}/actions/runs/{run_id}/logs Github Actions Delete Workflow Run Logs #
GET /repos/{owner}/{repo}/actions/runs/{run_id}/pending_deployments Github Actions Get Pending Deployments for a Workflow Run #
POST /repos/{owner}/{repo}/actions/runs/{run_id}/pending_deployments Github Actions Review Pending Deployments for a Workflow Run #
POST /repos/{owner}/{repo}/actions/runs/{run_id}/rerun Github Actions Re-run a Workflow #
POST /repos/{owner}/{repo}/actions/runs/{run_id}/rerun-failed-jobs Github Actions Re-run Failed Jobs From a Workflow Run #
GET /repos/{owner}/{repo}/actions/runs/{run_id}/timing Github Actions Get Workflow Run Usage #

Documentation

📖
Documentation
https://docs.github.com/en/rest/actions
📖
Authentication
https://docs.github.com/en/rest/overview/authenticating-to-the-rest-api
📖
GettingStarted
https://docs.github.com/en/actions/get-started/quickstart
📖
APIReference
https://docs.github.com/en/rest/actions
📖
RateLimits
https://docs.github.com/en/rest/overview/rate-limits-for-the-rest-api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/github-actions/refs/heads/main/openapi/github-actions-workflow-runs-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/github-actions/refs/heads/main/json-schema/github-actions-workflow-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/github-actions/refs/heads/main/json-schema/github-actions-run-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/github-actions/refs/heads/main/json-schema/github-actions-job-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/github-actions/refs/heads/main/json-schema/github-actions-artifact-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/github-actions/refs/heads/main/json-schema/github-actions-secret-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/github-actions/refs/heads/main/json-schema/github-actions-runner-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/github-actions/refs/heads/main/json-schema/github-actions-variable-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/github-actions/refs/heads/main/json-schema/github-actions-cache-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/github-actions/refs/heads/main/json-schema/github-actions-simple-user-schema.json

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/github-actions/refs/heads/main/overlays/github-actions-workflow-runs-api-overlay.yaml
🔗
ChangeLog
https://github.blog/changelog/label/actions/
🔗
SDKs
https://github.com/octokit/octokit.js
🔗
SDKs
https://github.com/octokit/octokit.rb
🔗
SDKs
https://github.com/octokit/octokit.net
🔗
SDKs
https://github.com/google/go-github
🔗
CLI
https://cli.github.com/manual/gh_workflow_run
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/github-actions/refs/heads/main/json-ld/github-actions-context.jsonld

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/github-actions-workflow-runs-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

github-actions-workflow-runs-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: GitHub Actions Workflow Runs API
  description: REST API for managing GitHub Actions workflows, runs, artifacts, secrets, runners, caches, variables, permissions, and OIDC.
  version: 1.0.0
  contact:
    name: GitHub Support
    url: https://support.github.com
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
- url: https://api.github.com
  description: GitHub REST API
security:
- bearerAuth: []
- personalAccessToken: []
tags:


# --- truncated at 32 KB (36 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/github-actions/refs/heads/main/openapi/github-actions-workflow-runs-api-openapi.yml