---
title: "Cancel Workflow"
method: POST
path: "/v1/workflow_run/cancel/"
---

# Cancel Workflow

`POST /v1/workflow_run/cancel/`

API to cancel a running workflow execution. You can cancel a workflow by passing any combination of filters in the request body. When multiple parameters are provided, they are **ANDed** together to narrow down the matching workflow runs.

For example, passing both `workflow_slug` and `recipients` will cancel only the workflow runs that match both the given slug and recipients.

## Request body

- object — Filter parameters to identify workflow runs to cancel. At least one parameter must be provided. When multiple parameters are passed, they are **ANDed** together.
  - `execution_id` string — Unique execution identifier of the workflow run to cancel. You can find this in the workflow logs on the SuprSend dashboard.
  - `recipients` string[] — List of recipient identifiers (distinct_id or contact info) whose workflow runs should be cancelled.
  - `idempotency_key` string — Idempotency key that was passed when triggering the workflow. Use this to cancel a specific workflow triggered with a known idempotency key.
  - `workflow_slug` string — Slug of the workflow whose runs should be cancelled.

## Response `200`

200 - OK

- object
  - `execution_ids` string[] — List of workflow execution IDs that were successfully cancelled. Empty array if no matching workflow runs were found.

## Other responses

- `400` — 400 - Bad Request

---

[API](https://skmtc.net/suprsend/apis/suprsend-api.md) · [All operations](https://skmtc.net/suprsend/apis/suprsend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/suprsend/suprsend-api/versions/8bd2574bd2c3/schema)