Skip to main content
DELETE
Delete Runner

Overview

Permanently delete a runner from your account. This action cannot be undone.
Deleting a runner is permanent. Any workflows currently using this runner may fail. Consider setting the runner status to disabled instead if you want to temporarily prevent its use.

Path Parameters

string
required
The unique identifier (UUID) of the runner to delete.

Response

Returns a 200 OK status with no body on successful deletion.

Example Response

Error Responses

error
Unauthorized - invalid or missing authentication token.
error
Not Found - runner with the specified ID does not exist or does not belong to your account.

Notes

  • This action is permanent and cannot be undone
  • Consider disabling the runner instead if you want to temporarily prevent its use
  • You can only delete runners that belong to your account
  • After deletion, you can create a new runner with the same name or configuration if needed