# CircleCI Self-Hosted Runner API

**Canonical:** https://apis.io/apis/circleci/runner-api/  
**Provider:** CircleCI — https://apis.io/providers/circleci/  
**Base URL:** https://runner.circleci.com  
**Documentation:** https://circleci.com/docs/runner-api/

CircleCI Self-Hosted Runner API is one of 18 APIs that [CircleCI](https://apis.io/providers/circleci/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include CI/CD, Infrastructure, Runners, and Self-Hosted. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.

The CircleCI Self-Hosted Runner API enables management and execution of jobs on self-hosted runner infrastructure. It provides endpoints for listing available runners, managing runner tasks, and querying resource classes. The API is hosted separately from the main CircleCI API at runner.circleci.com and supports multiple authentication methods depending on the endpoint. Developers can use this API to integrate self-hosted runner management into their infrastructure automation workflows.

## Machine-readable artifacts (3)

- **Documentation** — https://circleci.com/docs/runner-api/
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/circleci/refs/heads/main/openapi/circleci-runner-api-openapi.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/circleci/refs/heads/main/apis.yml

## Other CircleCI APIs (12)

- [CircleCI Webhooks](https://apis.io/apis/circleci/webhooks/)
- [CircleCI Orbs Registry](https://apis.io/apis/circleci/orbs/)
- [CircleCI Artifact API](https://apis.io/apis/circleci/circleci-artifact-api/)
- [CircleCI Build API](https://apis.io/apis/circleci/circleci-build-api/)
- [CircleCI Context API](https://apis.io/apis/circleci/circleci-context-api/)
- [CircleCI Insights API](https://apis.io/apis/circleci/circleci-insights-api/)
- [CircleCI Job API](https://apis.io/apis/circleci/circleci-job-api/)
- [CircleCI Pipeline API](https://apis.io/apis/circleci/circleci-pipeline-api/)
- [CircleCI Project API](https://apis.io/apis/circleci/circleci-project-api/)
- [CircleCI Resource Class API](https://apis.io/apis/circleci/circleci-resource-class-api/)
- [CircleCI Runner Task API](https://apis.io/apis/circleci/circleci-runner-task-api/)
- [CircleCI Schedule API](https://apis.io/apis/circleci/circleci-schedule-api/)

## Tags

CI/CD, Infrastructure, Runners, Self-Hosted

---

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