---
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.

Parameters:
    run_id (UUID): The identifier of the run to cancel.
    identity (LocalScopeDep): The authenticated user's workspace scope.
    lifecycle (RunLifecycleDep): The run lifecycle service.

Returns:
    CancellationResponse: The run identifier and resulting cancellation state.

## 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

- `422` — Validation Error

## Changes

- **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-service-production.skmtc.workers.dev/v1/apis/qredence/fleet-rlm/revisions/d23b9dd6e909/schema)