broadcasts
Delete a broadcast
DELETE /v1/broadcasts/{id}
Auth required
api.broadcasts.manage
Permanently deletes a broadcast. The common use is cleaning up the draft
broadcasts you create only to test-send: a test send
(POST /v1/broadcasts/{id}/test) requires a persisted broadcast, so
iterating on content leaves drafts behind.
Refuses with 422 validation_failed while the broadcast is sending;
returns 404 not_found when the id is not a broadcast in this org.
DELETE is idempotent by HTTP semantics, so no Idempotency-Key is needed.
Path parameters
id string<uuid> required Resource UUID. An unparseable id reads as a clean 404 not_found.
Responses
204 Broadcast deleted
401 Missing, malformed, or unknown API key application/problem+json
403 Key lacks the required scope or plan limit violated application/problem+json
404 Resource not found application/problem+json
422 Query parameter or path value failed validation application/problem+json
429 Per-org rate limit exceeded application/problem+json
500 Unexpected server-side failure. The
code is internal_error. The
request_id field can be quoted to SendOps support to investigate.
application/problem+json