# Set self-hosted runners in a group for an organization

From **GitHub v3 REST API**.

`PUT /orgs/{org}/actions/runner-groups/{runner_group_id}/runners`

Replaces the list of self-hosted runners that are part of an organization runner group.
You must authenticate using an access token with the `admin:org` scope to use this endpoint.

## Parameters

### `org`

- Location: path
- Required: true
- Type: `string`

### `runner_group_id`

- Location: path
- Required: true
- Type: `integer`

Unique identifier of the self-hosted runner group.

## Request body

- Required: true
### `application/json`

- Type: `object`

```json
{
  "runners": [
    9,
    2
  ]
}
```

```json
{"properties":{"runners":{"description":"List of runner IDs to add to the runner group.","items":{"description":"Unique identifier of the runner.","type":"integer"},"type":"array"}},"required":["runners"],"type":"object"}
```

## Responses

### `204`

Response

## Request examples

### cURL

```shell
curl --request PUT \
  --url {protocol}://{hostname}/api/v3/orgs/{org}/actions/runner-groups/{runner_group_id}/runners \
  --header 'content-type: application/json' \
  --data '{
  "runners": [
    9,
    2
  ]
}'
```
