discard_run

Cancel a paused Terraform run without applying changes, unlocking the workspace for new runs. Use this to discard unwanted plans or rejected configurations, providing an optional comment for reference.

Instructions

Discard a run that is paused waiting for confirmation

Cancels a run without applying its changes, typically used when the plan
shows undesired changes or after reviewing and rejecting a plan. This action
removes the run from the queue and unlocks the workspace for new runs.

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

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

Returns:
    Run status update with discarded state information, timestamp of the
    discard action, and user information

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

terraform-cloud-mcp

discard_run

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from terraform-cloud-mcp

Related Tools

MCP directory API