discard_run
Cancel a paused Terraform Cloud run without applying changes. Use this to remove undesired plans from the queue, unlock the workspace for new runs, and provide optional comments.
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.md for reference documentation
Input Schema
Name | Required | Description | Default |
---|---|---|---|
comment | No | ||
run_id | Yes |