enterprise-admin

Get a self-hosted runner for an enterprise

Changed on

Gets a specific self-hosted runner configured in an enterprise.

OAuth app tokens and personal access tokens (classic) need the manage_runners:enterprise scope to use this endpoint.

get/enterprises/{enterprise}/actions/runners/{runner_id}

Request

  • Base URL: https://api.github.com
  • URL: https://api.github.com/enterprises/{enterprise}/actions/runners/{runner_id}
  • Auth: none declared

Path parameters

enterprisestring required

The slug version of the enterprise name.

runner_idinteger required

Unique identifier of the self-hosted runner.

Response

Response

idinteger required

The ID of the runner.

runner_group_idinteger

The ID of the runner group.

namestring required

The name of the runner.

osstring required

The Operating System of the runner.

statusstring required

The status of the runner.

busyboolean required
ephemeralboolean
versionstring nullable

The version of the GitHub Actions Runner software. This is only set if the runner has connected to the service at least once.

Example response

{
  "id": 5,
  "runner_group_id": 1,
  "name": "iMac",
  "os": "macos",
  "status": "online",
  "version": "2.323.0"
}

Changes