Skip to main content
DELETE
/
cloud
/
alerts
/
statuses
/
{key}
curl -X DELETE 'https://api.cloud.blnkfinance.com/alerts/statuses/PENDING_REVIEW' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "message": "Status deleted"
}
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

curl -X DELETE 'https://api.cloud.blnkfinance.com/alerts/statuses/PENDING_REVIEW' \
  -H 'Authorization: Bearer YOUR_API_KEY'
​
key
string
required
The status key to delete (e.g. PENDING_REVIEW). Case-insensitive.

​
Response structure

{
  "message": "Status deleted"
}
​
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: 
{
  "error": "cannot delete status: 3 alert(s) use this status — reassign them to another status first"
}
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.