Skip to content

โŒ Cancel Scheduled Broadcast

Endpoint: POST /api/admin/notifications/broadcasts/{broadcast_id}/cancel/
Auth Required: โœ… Yes (Admin Bearer Token)
Content-Type: application/json


๐Ÿ“Œ Description

This endpoint allows administrators to cancel a previously scheduled broadcast before it is delivered.

Once cancelled: - the broadcast will not be sent - users will not receive the notification - the record remains for audit and history

Only scheduled broadcasts can be cancelled.


๐Ÿ” Authentication

Include the admin access token in the request header:


๐Ÿ”— Path Parameter

Parameter Type Required Description
broadcast_id UUID โœ… Broadcast identifier

๐Ÿ”„ Cancellation Rules

  • Only broadcasts with status scheduled can be cancelled
  • Sent broadcasts cannot be cancelled
  • Cancelled broadcasts cannot be reactivated
  • Cancellation reason is recommended for audit

๐Ÿงพ Request Body (Optional)

```json { "reason": "Event postponed due to weather conditions." }