Delete a self-hosted runner from an organization

Forces the removal of a self-hosted runner from an organization. You can use this endpoint to completely remove the runner when the machine you were using no longer exists. You must authenticate using an access token with the `admin:org` scope to use this endpoint.

DELETE/orgs/{org}/actions/runners/{runner_id}

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

Request

Path Parameters

org string required
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_id *

Unique identifier of the self-hosted runner.

Request Sample: Shell / cURL

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