Get a self-hosted runner for an organization

Gets a specific self-hosted runner configured in an organization. You must authenticate using an access token with the `admin:org` scope to use this endpoint.

Script github Verified

by hugo697 ยท 10/25/2023

The script

Submitted by hugo697 Typescript (fetch-only)
Verified 366 days ago
1
type Github = {
2
  token: string;
3
};
4
/**
5
 * Get a self-hosted runner for an organization
6
 * Gets a specific self-hosted runner configured in an organization.
7

8
You must authenticate using an access token with the `admin:org` scope to use this endpoint.
9
 */
10
export async function main(auth: Github, org: string, runner_id: string) {
11
  const url = new URL(
12
    `https://api.github.com/orgs/${org}/actions/runners/${runner_id}`
13
  );
14

15
  const response = await fetch(url, {
16
    method: "GET",
17
    headers: {
18
      Authorization: "Bearer " + auth.token,
19
    },
20
    body: undefined,
21
  });
22
  if (!response.ok) {
23
    const text = await response.text();
24
    throw new Error(`${response.status} ${text}`);
25
  }
26
  return await response.json();
27
}
28