---
title: "Cancel a Run"
method: POST
path: "/runs/{run}/actions/cancel"
tags: ["runs"]
---

# Cancel a Run

`POST /runs/{run}/actions/cancel`

## Request

- Base URL: `https://example.scalr.io/api/iacp/v3`
- URL: `https://example.scalr.io/api/iacp/v3/runs/{run}/actions/cancel`
- Auth: HTTP bearer

Interrupt a run that is currently planning or applying.

Performing a cancel is roughly equivalent to hitting `ctrl+c` during a Terraform plan or
apply on the CLI. The running Terraform process is sent an `INT` signal, which instructs
Terraform to end its work and wrap up in the safest way possible.

## Path parameters

- `run` string, required

## Request body

- Comment: An optional explanation for why run action was done.
  - `comment` string: The reason.

## Response `202`

Successfully queued a cancel request.

## Other responses

- `204`: Run is already cancelled, nothing should be done.
- `404`: Run not found, or user unauthorized to perform action.
- `409`: Run was not planning or applying. Cancel not allowed.
- `4XX`: Client error.
- `5XX`: Server error.

---

[API](https://skmtc.dev/scalr/apis/scalr-iacp-api.md) - [All operations](https://skmtc.dev/scalr/apis/scalr-iacp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scalr/apis/scalr-iacp-api/revisions/d3e1dc85657a?raw)