List self-hosted runner groups for an organization

Lists all self-hosted runner groups configured in an organization and inherited from an enterprise. You must authenticate using an access token with the `admin:org` scope to use this endpoint.

GET/orgs/{org}/actions/runner-groups

Source: github-v3-rest.json
Revision: f5f067c1e6f6
Active snapshot: 85e53e3d0d65

Request

Path Parameters

org string required

Query Parameters

per_page integer optional: Results per page (max 100)
page integer optional: Page number of the results to fetch.

Responses

application/json object

Response

runner_groups array[runner-groups-org object]

required

items runner-groups-org object

allows_public_repositories boolean

required

default boolean

required

id number

required

inherited boolean

required

inherited_allows_public_repositories boolean

optional

name string

required

runners_url string

required

selected_repositories_url string

optional

Link to the selected repositories resource for this runner group. Not present unless visibility was set to `selected`

visibility string

required

total_count number

required

Response Example: 200 application/json

{
  "runner_groups": [
    {
      "allows_public_repositories": true,
      "default": true,
      "id": 1,
      "inherited": false,
      "name": "Default",
      "runners_url": "https://api.github.com/orgs/octo-org/actions/runner_groups/1/runners",
      "visibility": "all"
    },
    {
      "allows_public_repositories": true,
      "default": false,
      "id": 2,
      "inherited": true,
      "name": "octo-runner-group",
      "runners_url": "https://api.github.com/orgs/octo-org/actions/runner_groups/2/runners",
      "selected_repositories_url": "https://api.github.com/orgs/octo-org/actions/runner_groups/2/repositories",
      "visibility": "selected"
    },
    {
      "allows_public_repositories": true,
      "default": false,
      "id": 3,
      "inherited": false,
      "name": "expensive-hardware",
      "runners_url": "https://api.github.com/orgs/octo-org/actions/runner_groups/3/runners",
      "visibility": "private"
    }
  ],
  "total_count": 3
}

Request configuration

This OpenAPI document does not declare an authentication scheme. Check the API provider's documentation before sending credentials; Manja cannot infer or validate an undocumented scheme.

Common bearer example: Authorization: Bearer YOUR_ACCESS_TOKEN

hostname

Self-hosted Enterprise Server or Enterprise Cloud hostname

protocol

Self-hosted Enterprise Server or Enterprise Cloud protocol

org *

per_page

Results per page (max 100)

page

Page number of the results to fetch.

Request Sample: Shell / cURL

curl --request GET \
  --url {protocol}://{hostname}/api/v3/orgs/{org}/actions/runner-groups