SMSSubscribers
Delete SMS subscriber
Remove an SMS subscription from a dashboard.
DELETE /app/subscribers/sms/subscribers/{dashboardId}/{phone}
Permanently removes a subscriber record for the given dashboard and phone number.
If this was the subscriber's last subscription (pending or verified) in the organization, the unique-phone quota slot is released.
Path parameters
| Parameter | Type | Description |
|---|---|---|
dashboardId | uuid | Dashboard the subscription belongs to |
phone | string | E.164 subscriber phone (URL-encoded, e.g. %2B14155552671) |
Request
See API Basics for required headers.
Sample request
curl -X DELETE "https://api.statusdashboard.com/app/subscribers/sms/subscribers/a1b2c3d4-e5f6-7890-abcd-ef1234567890/%2B14155552671" \
-H "Authorization: Bearer bcf847abf5c6:def456"Sample response
Status: 204 No Content
No response body.
Error responses
| Status | When |
|---|---|
400 | Invalid path parameters |
403 | Requires admin or subscriber role, or feature disabled |
404 | Subscriber not found |