Runs API

Runs in Atlas represents a two step Terraform plan and a subsequent apply.

Runs are queued under environments and require a two-step confirmation workflow. However, environments can be configured to auto-apply to avoid this.

Run Attributes

Attribute Description Required
destroy If set to true, this run will be a destroy plan. No

Actions

The following actions can be perfomed on this resource.

Queue a run
POST /api/v1/enviromments/:username/:name/plan

Examples

Queueing a new run

Starts a new run (plan) in the environment. Requires a configuration version to be present on the environment to succeed, but will otherwise 404.

$ curl https://atlas.hashicorp.com/api/v1/environments/acmeinc/test/plan \
    -X POST \
    -d "" \
    -H "X-Atlas-Token: $ATLAS_TOKEN"