---
title: "Cancel Broadcast"
method: POST
path: "/v1/broadcast_run/cancel/"
---

# Cancel Broadcast

`POST /v1/broadcast_run/cancel/`

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

For example, passing both `list_id` and `idempotency_key` will cancel only the broadcast runs that match both the given list and idempotency key.

## Request body

- object — Filter parameters to identify broadcast 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 broadcast run to cancel. You can find this in the broadcast logs on the SuprSend dashboard.
  - `list_id` string — Identifier of the user list whose broadcast runs should be cancelled.
  - `idempotency_key` string — Idempotency key that was passed when triggering the broadcast. Use this to cancel a specific broadcast triggered with a known idempotency key.

## Response `200`

200 - OK

- object
  - `execution_ids` string[] — List of broadcast execution IDs that were successfully cancelled. Empty array if no matching broadcast 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)