---
title: "Cancel a run"
method: PATCH
path: "/runs/{run_id}"
tags: ["runs"]
---

# Cancel a run

`PATCH /runs/{run_id}`

Cancels a run that is still queued or running, scoped to the caller's org. A run that has already reached a terminal state (completed/failed/cancelled) cannot be cancelled and reads as not found.

## Path parameters

- `run_id` string, uuid, required — run identifier

## Response `200`

OK

- RunSuccessResponse — Generic success message returned by run mutation endpoints.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `message` string, required — Human-readable result description.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/axilioai/apis/axilio-api.md) · [All operations](https://skmtc.net/axilioai/apis/axilio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/axilioai/axilio-api/revisions/108ab4b41051/schema)