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

---

[API](https://skmtc.net/qredence/apis/fleet-rlm.md) · [All operations](https://skmtc.net/qredence/apis/fleet-rlm/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qredence/fleet-rlm/revisions/4fdf9cecc886/schema)