Sign in
actions

List self-hosted runners for a repository

Lists all self-hosted runners configured in a repository.

Authenticated users must have admin access to the repository to use this endpoint.

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

get/repos/{owner}/{repo}/actions/runners

Path parameters

ownerstring required

The account owner of the repository. The name is not case sensitive.

repostring required

The name of the repository without the .git extension. The name is not case sensitive.

Query parameters

namestring

The name of a self-hosted runner.

per_pageinteger

The number of results per page (max 100). For more information, see "Using pagination in the REST API."

pageinteger

The page number of the results to fetch. For more information, see "Using pagination in the REST API."

Response

Response

total_countinteger required

Example response

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

Changes

Changed in 1 of the 62 revisions of this API.1

  • 2022-11-2838dab91d27541See the full diff
    • ○

      added the optional property runners/items/version to the response with the 200 status

      response-optional-property-added

Of the 62 revisions, 1 has no diff computed.