Terraform Cloud icon

Terraform Cloud

Interact with the Terraform Cloud API

Actions16

Run → Discard Run

AI-generated

Summary

Discard a specific Terraform Cloud run that is waiting or paused, optionally providing a reason or comment for the discard action.

Inputs

  • Run ID (required) — The unique identifier of the run you want to discard.
  • Reason / Comment — An optional comment explaining the reason for discarding the run; this comment is attached to the discard action.

Output shape

A JSON object containing the run ID, the discard action performed, HTTP status code, and the full API response.

The operation returns the full API response for the discard action including HTTP status code and any data returned by Terraform Cloud. The response is paired with the input item index if multiple runs are processed.

Examples

Example 1: Discarding a waiting or paused run with an optional reason

Provide the Run ID to specify which run to discard and optionally include a reason or comment that will be recorded with the action.

Links

Discussion