Search + K

Command Palette

Search for a command to run...

Sign In

Create a self-hosted runner group for an organization

POST /orgs/{org}/actions/runner-groups
Copy endpoint
https://api.github.com

Creates a new self-hosted runner group for an organization.

OAuth tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

Parameters

path Path Parameters

Name Type
org required

The organization name. The name is not case sensitive.

string

Request Body

application/json required
{
name: string;
visibility?: "selected" | "all" | "private";
selected_repository_ids?: number[];
runners?: number[];
allows_public_repositories?: boolean;
restricted_to_workflows?: boolean;
selected_workflows?: string[];
network_configuration_id?: string;
}

Responses

201 application/json

Response

interface RunnerGroupsOrg {
id: number;
name: string;
visibility: string;
default: boolean;
selected_repositories_url?: string;
runners_url: string;
hosted_runners_url?: string;
network_configuration_id?: string;
inherited: boolean;
inherited_allows_public_repositories?: boolean;
allows_public_repositories: boolean;
workflow_restrictions_read_only?: boolean;
restricted_to_workflows?: boolean;
selected_workflows?: string[];
}