Delete a self-hosted runner from a repository

Forces the removal of a self-hosted runner from a repository. 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 `repo` scope to use this endpoint.

DELETE/repos/{owner}/{repo}/actions/runners/{runner_id}

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

Request

Path Parameters

owner string required
repo 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

owner *

repo *

runner_id *

Unique identifier of the self-hosted runner.

Request Sample: Shell / cURL

curl --request DELETE \
  --url {protocol}://{hostname}/api/v3/repos/{owner}/{repo}/actions/runners/{runner_id}