Query all host runners under the specified runner group¶

{
  "error": "invalid_request",
  "message": "The runner_group_id parameter cannot be empty",
  "field": "runner_group_id"
}

{
  "error": "unauthorized",
  "message": "Missing or invalid access token"
}

{
  "error": "not_found",
  "message": "The specified runner group does not exist"
}

curl -X GET 'https://api.atomgit.com/api/v8/orgs/<org>/actions/runner-groups/<runner_group_id>/runners?access_token=<token>&keyword=<keyword>&page=1&per_page=10' \
  -H 'Accept: application/json'

// Native fetch (Node.js 18+ / browser)
const params = new URLSearchParams({
  access_token: "<YOUR-TOKEN>",
  keyword: "build",
  page: "1",
  per_page: "10",
});

const response = await fetch(
  `https://api.atomgit.com/api/v8/orgs/<org>/actions/runner-groups/<runner_group_id>/runners?${params}`,
  {
    headers: { "Accept": "application/json" },
  }
);

if (!response.ok) {
  throw new Error(`Request failed: ${response.status}`);
}

const data = await response.json();
console.log(data);

import requests

resp = requests.get(
    "https://api.atomgit.com/api/v8/orgs/<org>/actions/runner-groups/<runner_group_id>/runners",
    params={
        "access_token": "<YOUR-TOKEN>",
        "keyword": "build",
        "page": 1,
        "per_page": 10,
    },
    headers={"Accept": "application/json"},
    timeout=10,
)
resp.raise_for_status()

print(resp.json())

{
  "total_count": 0,
  "runners": [
    {
      "id": "string",
      "runner_group_id": "string",
      "runner_name": "string",
      "name": "string",
      "work_dir": "string",
      "labels": [
        {
          "label_name": "string",
          "label_value": "string",
          "label_color": "string"
        }
      ],
      "status": "IDLE",
      "create_time": 0,
      "update_time": 0,
      "memory": 0,
      "disk": 0
    }
  ]
}