# GitHub Actions Self-Hosted Runners API

**Canonical:** https://apis.io/apis/github-actions/github-actions-self-hosted-runners-api/  
**Provider:** GitHub Actions — https://apis.io/providers/github-actions/  
**Base URL:** https://api.github.com  
**Documentation:** https://docs.github.com/en/actions

GitHub Actions Self-Hosted Runners API is one of 11 APIs that [GitHub Actions](https://apis.io/providers/github-actions/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 9 JSON Schema definitions. Tagged areas include Self-Hosted Runners. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, a getting-started guide, an API reference, a changelog, and 9 JSON Schemas.

Manage self-hosted runners for workflows

## Operations (11)

| Method | Path | Summary |
|---|---|---|
| GET | `/repos/{owner}/{repo}/actions/runners` | Github Actions List Self-hosted Runners for a Repository |
| GET | `/repos/{owner}/{repo}/actions/runners/{runner_id}` | Github Actions Get a Self-hosted Runner for a Repository |
| DELETE | `/repos/{owner}/{repo}/actions/runners/{runner_id}` | Github Actions Delete a Self-hosted Runner From a Repository |
| GET | `/repos/{owner}/{repo}/actions/runners/downloads` | Github Actions List Runner Applications for a Repository |
| POST | `/repos/{owner}/{repo}/actions/runners/registration-token` | Github Actions Create a Registration Token for a Repository |
| POST | `/repos/{owner}/{repo}/actions/runners/remove-token` | Github Actions Create a Remove Token for a Repository |
| GET | `/repos/{owner}/{repo}/actions/runners/{runner_id}/labels` | Github Actions List Labels for a Self-hosted Runner for a Repository |
| POST | `/repos/{owner}/{repo}/actions/runners/{runner_id}/labels` | Github Actions Add Custom Labels to a Self-hosted Runner for a Repository |
| PUT | `/repos/{owner}/{repo}/actions/runners/{runner_id}/labels` | Github Actions Set Custom Labels for a Self-hosted Runner for a Repository |
| DELETE | `/repos/{owner}/{repo}/actions/runners/{runner_id}/labels` | Github Actions Remove All Custom Labels From a Self-hosted Runner for a Repository |
| DELETE | `/repos/{owner}/{repo}/actions/runners/{runner_id}/labels/{name}` | Github Actions Remove a Custom Label From a Self-hosted Runner for a Repository |

## Machine-readable artifacts (22)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/github-actions/refs/heads/main/openapi/github-actions-self-hosted-runners-api-openapi.yml
- **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
- **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
- **RateLimits** — https://docs.github.com/en/rest/overview/rate-limits-for-the-rest-api
- **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
- **JSONLD** — https://raw.githubusercontent.com/api-evangelist/github-actions/refs/heads/main/json-ld/github-actions-context.jsonld

## Other GitHub Actions APIs (10)

- [GitHub Actions Artifacts API](https://apis.io/apis/github-actions/github-actions-artifacts-api/)
- [GitHub Actions Cache API](https://apis.io/apis/github-actions/github-actions-cache-api/)
- [GitHub Actions Jobs API](https://apis.io/apis/github-actions/github-actions-jobs-api/)
- [GitHub Actions OIDC API](https://apis.io/apis/github-actions/github-actions-oidc-api/)
- [GitHub Actions Permissions API](https://apis.io/apis/github-actions/github-actions-permissions-api/)
- [GitHub Actions Secrets API](https://apis.io/apis/github-actions/github-actions-secrets-api/)
- [GitHub Actions Self-Hosted Runner Groups API](https://apis.io/apis/github-actions/github-actions-self-hosted-runner-groups-api/)
- [GitHub Actions Variables API](https://apis.io/apis/github-actions/github-actions-variables-api/)
- [GitHub Actions Workflow Runs API](https://apis.io/apis/github-actions/github-actions-workflow-runs-api/)
- [GitHub Actions Workflows API](https://apis.io/apis/github-actions/github-actions-workflows-api/)

## Tags

Self-Hosted Runners

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/github-actions/github-actions-self-hosted-runners-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/github-actions/.