Terraform Cloud icon

Terraform Cloud

Interact with the Terraform Cloud API

Actions16

Run → Create Plan (Manual Apply)

AI-generated

Summary

Create a Terraform Cloud run that initiates a plan operation in a specified workspace, leaving the run in a pending state that requires manual approval to apply.

Inputs

  • Workspace ID (required) — The unique ID of the workspace where the plan run will be created.
  • Message — Optional message to attach to the run, such as a description or note about the plan.

Output shape

A single run object representing the created plan, including metadata returned by the Terraform Cloud API.

The operation sends a POST request to create the run and returns the full API response JSON. The run will be created with manual apply mode, meaning it will not automatically apply after planning and will wait for manual approval or discard.

Links

Discussion