---
title: "Create a Run"
method: POST
path: "/runs"
tags: ["runs"]
---

# Create a Run

`POST /runs`

A run performs terraform plan and apply using a configuration version and
the workspace's current variables. If the configuration version is omitted, the run will
be created using the workspace's latest configuration version. If you want to create a
dry run, specify `is-dry: true` or reference configuration version with `is-dry: true`
in the relationships.

## Query parameters

- `vcs-user-id` integer
- `vcs-task-id` string

## Response `201`

Successfully created a run.

## Other responses

- `404` — Environment or workspace not found, or user unauthorized to perform action.
- `422` — Invalid attributes.
- `4XX` — Client error.
- `5XX` — Server error.

---

[API](https://skmtc.net/scalr/apis/scalr-iacp-api.md) · [All operations](https://skmtc.net/scalr/apis/scalr-iacp-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalr/scalr-iacp-api/revisions/fc927526ad12/schema)