Set self-hosted runners in a group for an enterprise

PUT

/enterprises/{enterprise}/actions/runner-groups/{runner_group_id}/runners

Replaces the list of self-hosted runners that are part of an enterprise runner group.

You must authenticate using an access token with the admin:enterprise scope to use this endpoint.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.github.com/enterprises//actions/runner-groups//runners' \
--header 'Content-Type: application/json' \
--data-raw '{
    "runners": [
        9,
        2
    ]
}'

Response Example

{}

Request

Path Params

enterprise

string

required

The slug version of the enterprise name. You can also substitute this value with the enterprise id.

runner_group_id

integer

required

Unique identifier of the self-hosted runner group.

Body Params application/json

runners

array[integer]

required

List of runner IDs to add to the runner group.

Examples

Responses

🟢204Empty response

application/json

Body

object {0}

Modified at 2022-09-10 00:54:29

List self-hosted runners in a group for an enterprise

Remove a self-hosted runner from a group for an enterprise