---
title: "POST /workflowruns/{workflowRunId}/cancel"
method: POST
path: "/workflowruns/{workflowRunId}/cancel"
tags: ["WorkflowRuns"]
---

# POST /workflowruns/{workflowRunId}/cancel

`POST /workflowruns/{workflowRunId}/cancel`

Cancel a workflow run.

## Path parameters

- `workflowRunId` string, uuid, required

## Query parameters

- `api-version` string, required

## Request body

- WorkflowRunCancelRequest
  - `comment` string — The comment of canceling a workflow run.

## Response `200`

OK

## Other responses

- `default` — Error response describing why the operation failed.

## Changes

- **2026-07-13** (2022-05-01-preview) `60435bfd503d` — 1 info
  - api operation id `CancelWorkflowRun` removed and replaced with `WorkflowRun_Cancel`

[Change history](https://skmtc.dev/azure/apis/purview-workflow/changes/workflowruns/:workflowRunId/cancel/post.md)

---

[API](https://skmtc.dev/azure/apis/purview-workflow.md) · [All operations](https://skmtc.dev/azure/apis/purview-workflow/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/purview-workflow/revisions/60435bfd503d/schema)