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

# Complete Workflow Run

> Finish a workflow run early

Mark a workflow run complete before the agent has finished conducting it. Outreach to the lead stops, queued messages are cancelled, and whatever the workflow had left to do is skipped. Completing is final.

If the workflow is configured to mark the lead completed, the lead is completed too and a [`lead.completed`](https://docs.monumint.com/api-reference/webhooks/events/lead-completed) webhook fires after [`workflow_run.completed`](https://docs.monumint.com/api-reference/webhooks/events/workflow-run-completed).

A workflow run also completes on its own, without this call, once the workflow has nothing left to do.

Completing a workflow run that is already `COMPLETED` 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 complete.

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 `CANCELLED`, or this workflow's runs cannot be
completed manually. The error message says which.

```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/complete",
  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/complete"
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/complete \
  --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": "COMPLETED",
    "createdAt": "2026-09-10T17:42:03.000Z",
    "completedAt": "2026-09-10T18:00:00.000Z",
    "cancelledAt": null
  }
}
```


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