force_cancel_run
Immediately terminate a stuck Terraform Cloud run that is unresponsive to regular cancellation requests. Unlocks the workspace and confirms the forced cancellation with a timestamp and user details.
Instructions
Forcefully cancel a run immediately
Immediately terminates a run that hasn't responded to a normal cancel request. Use this as a last resort when a run is stuck and not responding to regular cancellation. This action bypasses the graceful shutdown process and forces the workspace to be unlocked.
API endpoint: POST /runs/{run_id}/actions/force-cancel
Args: run_id: The ID of the run to force cancel (format: "run-xxxxxxxx") comment: An optional explanation for why the run was force canceled
Returns: Run status update confirming forced cancellation with timestamp, user information, and workspace unlock status
See: docs/tools/run.md for reference documentation
Input Schema
Name | Required | Description | Default |
---|---|---|---|
comment | No | ||
run_id | Yes |