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


The following actions can be perfomed on this resource.

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


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 \
    -X POST \
    -d "" \
    -H "X-Atlas-Token: $ATLAS_TOKEN"