Skip to main content
DELETE
https://api.cloud.blnkfinance.com
/
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?

If you’re having trouble with Blnk Cloud, don’t hesitate to send us a message via email at [email protected] or send us a message here.