Skip to main content
DELETE
Delete a custom alert status by key. The request fails if any alerts in the organization still use this status; reassign those alerts to another status first.

Request structure

key
string
required
The status key to delete (e.g. PENDING_REVIEW). Case-insensitive.

Response structure

message
string
required
Confirmation message when the status is deleted.

Error when status is in use

If one or more alerts still use this status, the API returns an error and does not delete the status:
Reassign those alerts (e.g. via Update alert) to another status, then call delete again.

Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.