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

# Discard a Run

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

Skip any remaining work on runs that are paused waiting for confirmation or priority.

This includes runs in the `pending`, `planned`, `policy_checked` and `policy_override` states.

## 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 discard request.

## Other responses

- `404` — Run not found, or user unauthorized to perform action.
- `409` — Run was not paused for confirmation or priority. Discard not allowed.
- `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)