Skip to main content
DELETE
/
v1
/
runner
/
{id}
Delete Runner
curl --request DELETE \
  --url https://api.comfycontrol.app/v1/runner/{id} \
  --header 'Authorization: Bearer <token>'
{
  "401": {},
  "404": {}
}

​
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

​
id
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

Status: 200 OK

​
Error Responses

​
401
error
Unauthorized - invalid or missing authentication token.
​
404
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