cancel_run

Stop a Terraform Cloud run in progress during planning or applying. Gracefully terminates the run, reducing resource usage and allowing for cleanup. Requires the run ID and supports adding an optional cancellation comment.

Instructions

Cancel a run that is currently planning or applying

Gracefully stops an in-progress run during planning or applying phases. Use this
when you need to stop a run that's taking too long, consuming too many resources,
or needs to be stopped for any reason. The operation attempts to cleanly terminate
the run by sending an interrupt signal.

API endpoint: POST /runs/{run_id}/actions/cancel

Args:
    run_id: The ID of the run to cancel (format: "run-xxxxxxxx")
    comment: An optional explanation for why the run was canceled

Returns:
    Run status update with canceled state, timestamp of cancellation,
    and any provided comment in the response metadata

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": "cancel_runArguments",
  "type": "object"
}

terraform-cloud-mcp

cancel_run

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from terraform-cloud-mcp

Related Tools