force_cancel_run

Immediately terminate a stuck Terraform Cloud run that isn't responding to regular cancellation. Forcefully unlocks the workspace, bypassing graceful shutdown. Use when normal cancellation fails to resolve run issues.

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_tools.md for usage examples

Input Schema

Name	Required	Description	Default
`comment`	No
`run_id`	Yes

Input Schema (JSON Schema)

{
  "properties": {
    "comment": {
      "default": "",
      "title": "Comment",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    }
  },
  "required": [
    "run_id"
  ],
  "title": "force_cancel_runArguments",
  "type": "object"
}

terraform-cloud-mcp

force_cancel_run

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from terraform-cloud-mcp

Related Tools