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/orgs/{org}/actions/runner-groups/{runner_group_id}/runners/{runner_id}

Source: github-v3-rest.json
Revision: f5f067c1e6f6
Active snapshot: 85e53e3d0d65

Request

Path Parameters

org string required
runner_group_id integer required: Unique identifier of the self-hosted runner group.
runner_id integer required: Unique identifier of the self-hosted runner.

Responses

Response

Request configuration

This OpenAPI document does not declare an authentication scheme. Check the API provider's documentation before sending credentials; Manja cannot infer or validate an undocumented scheme.

Common bearer example: Authorization: Bearer YOUR_ACCESS_TOKEN

hostname

Self-hosted Enterprise Server or Enterprise Cloud hostname

protocol

Self-hosted Enterprise Server or Enterprise Cloud protocol

org *

runner_group_id *

Unique identifier of the self-hosted runner group.

runner_id *

Unique identifier of the self-hosted runner.

Request Sample: Shell / cURL

curl --request DELETE \
  --url {protocol}://{hostname}/api/v3/orgs/{org}/actions/runner-groups/{runner_group_id}/runners/{runner_id}