---
title: "Delete a  Broadcast"
method: DELETE
path: "/message/broadcast/{broadcast_id}"
tags: ["message"]
---

# Delete a  Broadcast

`DELETE /message/broadcast/{broadcast_id}`

This endpoint is used to delete or stop a broadcast.

- If the broadcast hasn't started yet, it will be deleted and the credits for this broadcast won't be charged.
- If it's currently sending, it will stop immediately. Any messages that haven't been sent yet will be cancelled, and the credits for them will be refunded.

## Path parameters

- `broadcast_id` string, required

## Response `200`

Broadcast was deleted or stopped successfully.

- object
  - `broadcast_id` string
  - `status` 'deleted' | 'stopped'

## Other responses

- `404` — Broadcast not found or does not belong to your organisation.
- `409` — Broadcast is already in a terminal state and cannot be cancelled.

---

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