v18

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014211,6201.8 MB

gitpod.v1.RunnerService

DeleteRunner

Deletes a runner permanently.

Use this method to:

Remove unused runners
Clean up runner registrations
Delete obsolete runners

Examples

Delete runner:

Permanently removes a runner.

runnerId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"

post/gitpod.v1.RunnerService/DeleteRunner

Request body

forceboolean

force indicates whether the runner should be deleted forcefully. When force deleting a Runner, all Environments on the runner are also force deleted and regular Runner lifecycle is not respected. Force deleting can result in data loss.

runnerIdstring uuid

Response

Success

GitpodV1DeleteRunnerResponse required