# OpenRelay Runners API

**Canonical:** https://apis.io/apis/openrelay/openrelay-runners-api/  
**Provider:** OpenRelay — https://apis.io/providers/openrelay/  
**Base URL:** https://api.openrelay.inc  
**Documentation:** https://docs.openrelay.inc

OpenRelay Runners API is one of 19 APIs that [OpenRelay](https://apis.io/providers/openrelay/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Runners. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Managed GitHub Actions runner pools.

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/orgs/{orgId}/runner-pools` | List runner pools (with active/queued usage) |
| POST | `/v1/orgs/{orgId}/runner-pools` | Create a runner pool |
| GET | `/v1/orgs/{orgId}/runner-pools/connect-url` | GitHub connect URL (OAuth authorize when configured, else App install) |
| POST | `/v1/orgs/{orgId}/runner-pools/installations` | List GitHub installations the user can connect (OAuth code exchange) |
| DELETE | `/v1/orgs/{orgId}/runner-pools/{id}` | Delete (or drain) a runner pool |
| GET | `/v1/orgs/{orgId}/runner-pools/{id}` | Get a runner pool (with usage) |
| GET | `/v1/orgs/{orgId}/runner-pools/{id}/jobs` | List runner jobs for a pool |
| GET | `/v1/orgs/{orgId}/runner-pools/{id}/metrics` | Runner pool job metrics (last 30 days) + cost comparison |
| POST | `/v1/orgs/{orgId}/runner-pools/{id}/resize` | Resize a runner pool's RAM tier |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/openrelay/refs/heads/main/openapi/openrelay-runners-api-openapi.yml
- **Documentation** — https://docs.openrelay.inc
- **APIReference** — https://docs.openrelay.inc/docs/account/overview

## Other OpenRelay APIs (12)

- [OpenRelay Inference API](https://apis.io/apis/openrelay/openrelay-inference-api/)
- [OpenRelay Account API](https://apis.io/apis/openrelay/openrelay-account-api/)
- [OpenRelay API Keys API](https://apis.io/apis/openrelay/openrelay-api-keys-api/)
- [OpenRelay Batches API](https://apis.io/apis/openrelay/openrelay-batches-api/)
- [OpenRelay Billing API](https://apis.io/apis/openrelay/openrelay-billing-api/)
- [OpenRelay Catalog API](https://apis.io/apis/openrelay/openrelay-catalog-api/)
- [OpenRelay Clusters API](https://apis.io/apis/openrelay/openrelay-clusters-api/)
- [OpenRelay Files API](https://apis.io/apis/openrelay/openrelay-files-api/)
- [OpenRelay Internal API](https://apis.io/apis/openrelay/openrelay-internal-api/)
- [OpenRelay Organizations API](https://apis.io/apis/openrelay/openrelay-organizations-api/)
- [OpenRelay Provider API](https://apis.io/apis/openrelay/openrelay-provider-api/)
- [OpenRelay Registry Credentials API](https://apis.io/apis/openrelay/openrelay-registry-credentials-api/)

## Tags

Runners

---

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