per_pageinteger
Results per page (max 100)
Default:30
pageinteger
Page number of the results to fetch.
Default:1
List self-hosted runners in a group for an organization
Lists self-hosted runners that are in a specific organization group.
You must authenticate using an access token with the admin:org scope to use this endpoint.
get
{protocol}://{hostname}/api/v3/orgs/{org}/actions/runner-groups/{runner_group_id}/runners
Query Parameters
Path Parameters
orgstringrequired
runner_group_idintegerrequired
Unique identifier of the self-hosted runner group.
Response
200 application/json
Response
200 application/json
Response
total_countnumberrequired
runnersarray[object]required
A self hosted runner
Show Child Parameters
get/orgs/{org}/actions/runner-groups/{runner_group_id}/runners
Path Parameters
Query Parameters
200 application/json
Set self-hosted runners in a group for an organization
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.
put
{protocol}://{hostname}/api/v3/orgs/{org}/actions/runner-groups/{runner_group_id}/runners
Path Parameters
orgstringrequired
runner_group_idintegerrequired
Unique identifier of the self-hosted runner group.
Body
application/json
Body
application/json
runnersarray[integer]required
Unique identifier of the runner.
Response
204
Response
204
Response
put/orgs/{org}/actions/runner-groups/{runner_group_id}/runners
Path Parameters
Body
{
"runners": [
9,
2
]
}
204
Add a self-hosted runner to a group for an organization
Adds a self-hosted runner to a runner group configured in an organization.
You must authenticate using an access token with the admin:org scope to use this endpoint.
put
{protocol}://{hostname}/api/v3/orgs/{org}/actions/runner-groups/{runner_group_id}/runners/{runner_id}
Path Parameters
orgstringrequired
runner_group_idintegerrequired
Unique identifier of the self-hosted runner group.
runner_idintegerrequired
Unique identifier of the self-hosted runner.
Response
204
Response
204
Response
put/orgs/{org}/actions/runner-groups/{runner_group_id}/runners/{runner_id}
Path Parameters
204
Remove a self-hosted runner from a group for an organization
Removes a self-hosted runner from a group configured in an organization. The runner is then returned to the default group.
You must authenticate using an access token with the admin:org scope to use this endpoint.
delete
{protocol}://{hostname}/api/v3/orgs/{org}/actions/runner-groups/{runner_group_id}/runners/{runner_id}
Path Parameters
orgstringrequired
runner_group_idintegerrequired
Unique identifier of the self-hosted runner group.
runner_idintegerrequired
Unique identifier of the self-hosted runner.
Response
204
Response
204
Response
delete/orgs/{org}/actions/runner-groups/{runner_group_id}/runners/{runner_id}
Path Parameters
204
List self-hosted runners for an organization
Lists all self-hosted runners configured in an organization.
You must authenticate using an access token with the admin:org scope to use this endpoint.
get
{protocol}://{hostname}/api/v3/orgs/{org}/actions/runners
Query Parameters
per_pageinteger
Results per page (max 100)
Default:30
pageinteger
Page number of the results to fetch.
Default:1
Path Parameters
orgstringrequired
Response
200 application/json
Response
200 application/json
Response
total_countintegerrequired
runnersarray[object]required
A self hosted runner
Show Child Parameters
get/orgs/{org}/actions/runners
Path Parameters
Query Parameters
200 application/json