StatusDashboard
EmailSubscribers

Delete email subscriber

Remove an email subscription from a dashboard.

View Markdown

DELETE /app/subscribers/email/subscribers/{dashboardId}/{email}

Permanently removes a subscriber record for the given dashboard and email address.

If this was the subscriber's last subscription (pending or verified) in the organization, the unique-email quota slot is released.


Path parameters

ParameterTypeDescription
dashboardIduuidDashboard the subscription belongs to
emailstringNormalized subscriber email address

Request

See API Basics for required headers.


Sample request

curl -X DELETE "https://api.statusdashboard.com/app/subscribers/email/subscribers/a1b2c3d4-e5f6-7890-abcd-ef1234567890/alice@acme.com" \
  -H "Authorization: Bearer bcf847abf5c6:def456"

Sample response

Status: 204 No Content

No response body.


Error responses

StatusWhen
400Invalid path parameters
403Requires admin or subscriber role, or feature disabled
404Subscriber not found

On this page

We use cookies

We use essential cookies to keep the site working, and optional analytics cookies to understand how it's used. Read our Privacy Policy.