---
title: "Request Run Cancellation"
method: PUT
path: "/api/runs/{run_id}/cancellation"
tags: ["runs"]
---

# Request Run Cancellation

`PUT /api/runs/{run_id}/cancellation`

Request cancellation for a run.

## Path parameters

- `run_id` string, uuid, required

## Response `200`

Successful Response

- CancellationResponse
  - `run_id` string, uuid, required
  - `state` 'requested' | 'already_requested' | 'already_terminal', required

## Other responses

- `404` — Run not found
- `422` — Validation Error
- `503` — Service is not ready

## Changes

- **2026-09-14** `571850c93e2c` — 2 info
  - added the non-success response with the status `404`
  - added the non-success response with the status `503`
- **2026-07-17** `655778279cb1` — 1 info
  - endpoint added
- **2026-07-17** `62e8c152aa18` — 1 breaking
  - api path removed without deprecation
- **2026-07-15** `216311cd30ec` — 3 warning
  - deleted the `header` request parameter `Authorization`
  - deleted the `header` request parameter `X-Fleet-User-Id`
  - deleted the `header` request parameter `X-Fleet-Workspace-Id`
- **2026-07-13** `f18c4c8586ca` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/qredence/apis/fleet-rlm/changes/api/runs/:run_id/cancellation/put.md)

---

[API](https://skmtc.dev/qredence/apis/fleet-rlm.md) · [All operations](https://skmtc.dev/qredence/apis/fleet-rlm/llms.txt) · [OpenAPI document](https://skmtc.dev/qredence/apis/fleet-rlm/revisions/6109fdb187b9?raw)