Broadcasts
DELETE
Delete Broadcast
DELETE /v1/broadcasts/{broadcastId}Delete a broadcast permanently.
Use Cases:
- Remove draft broadcasts that are no longer needed
- Delete queued broadcasts before they are sent
- Clean up test broadcasts
- Remove accidentally created broadcasts
Behavior:
- Only DRAFT or QUEUED broadcasts can be deleted
- Broadcast is permanently removed from the workspace
- Cannot delete broadcasts that have been sent or are sending
- Returns the deleted broadcast's ID for confirmation
Required Scope: write:broadcasts
Restrictions:
- Cannot delete broadcasts in SENDING status
- Cannot delete broadcasts in SENT status
- Cannot delete broadcasts in COMPLETED status
Important:
- Deletion is permanent and cannot be undone
- If you need to cancel a queued broadcast, delete it before the scheduled send time
Path parameters
broadcastIdstringrequiredBroadcast ID
Response
200Broadcast deleted successfully. Returns the deleted broadcast's ID for confirmation.
objectstringrequiredidstringrequired