> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monumint.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel Workflow Run

> Cancel a workflow run

Cancel a workflow run. The agent stops conducting the workflow, queued messages are cancelled, and the workflow run ends. Cancelling is final. To have the same agent conduct a workflow on this lead again, [create a new workflow run](https://docs.monumint.com/api-reference/workflow-runs/create-workflow-run.md).

Cancelling a workflow run that is already `CANCELLED` succeeds and changes nothing.

## Authentication

Requires the `x-api-key` header with a valid workspace API key.

## Path Parameters

**workflowRunId** `string` *required*

The workflow run to cancel.

This endpoint takes no body.

## Response

**success** `boolean`

Whether the request succeeded.

**workflowRun** `object`

The workflow run in its new state. See
[Get Workflow Run](https://docs.monumint.com/api-reference/workflow-runs/get-workflow-run.md) for the
full shape.

## Errors

**404** `error`

No workflow run with this id exists in your workspace.

**409** `error`

The workflow run is already `COMPLETED`. Terminal workflow runs cannot change status.

```javascript Node.js theme={null}
const options = {
  method: "POST",
  headers: { "x-api-key": "<your-api-key>" },
};

fetch(
  "https://api-v2.getomni.ai/api/v1/workflow-runs/5d8c1b2a-3e4f-5061-7283-94a5b6c7d8e9/cancel",
  options,
)
  .then((response) => response.json())
  .then((response) => console.log(response))
  .catch((err) => console.error(err));
```

```python Python theme={null}
import requests

url = "https://api-v2.getomni.ai/api/v1/workflow-runs/5d8c1b2a-3e4f-5061-7283-94a5b6c7d8e9/cancel"
headers = {"x-api-key": "<your-api-key>"}

response = requests.request("POST", url, headers=headers)
print(response.json())
```

```bash cURL theme={null}
curl --request POST \
  --url https://api-v2.getomni.ai/api/v1/workflow-runs/5d8c1b2a-3e4f-5061-7283-94a5b6c7d8e9/cancel \
  --header 'x-api-key: <your-api-key>'
```

```json 200 theme={null}
{
  "success": true,
  "workflowRun": {
    "id": "5d8c1b2a-3e4f-5061-7283-94a5b6c7d8e9",
    "leadId": "b1f0a790-201b-47e9-84ed-cc7eed1270c5",
    "agentId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "workflowId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "externalId": null,
    "status": "CANCELLED",
    "createdAt": "2026-09-10T17:42:03.000Z",
    "completedAt": null,
    "cancelledAt": "2026-09-10T18:00:00.000Z"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.