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

​
Overview

Send an interrupt signal to a ComfyUI runner to stop its current workflow execution. This is useful for cancelling long-running or stuck operations.
This sends an interrupt signal directly to the ComfyUI instance. The current workflow execution will be stopped immediately.

​
Path Parameters

​
id
string
required
The unique identifier (UUID) of the runner to interrupt.

​
Response

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

​
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.
​
500
error
Internal Server Error - unable to connect to the runner or send interrupt signal.Common causes:
  • Runner endpoint is unreachable
  • Runner is offline or not responding
  • Network connectivity issues
  • Invalid authentication headers configured for the runner

​
Notes

  • This endpoint makes a live request to your ComfyUI instance
  • The interrupt is sent immediately to the runner
  • Any currently executing workflow will be stopped
  • The workflow status may change to cancelled or failed depending on the execution state
  • Use this sparingly as it forcefully stops execution
  • Consider using the workflow cancel endpoint for graceful cancellation when possible
  • Response time depends on network latency to your runner