Authentication
Proxy API
Data API
Alerts
Delete alert status
Delete a custom alert status by key.
DELETE
/
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.Documentation Index
Fetch the complete documentation index at: https://guide.cloud.blnkfinance.com/llms.txt
Use this file to discover all available pages before exploring further.
Request structure
curl -X DELETE 'https://api.cloud.blnkfinance.com/alerts/statuses/PENDING_REVIEW' \
-H 'Authorization: Bearer YOUR_API_KEY'
The status key to delete (e.g. PENDING_REVIEW). Case-insensitive.
Response structure
{
"message": "Status deleted"
}
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"
}
Need help?
If you’re having trouble with Blnk Cloud, don’t hesitate to send us a message via email at support@blnkfinance.com or send us a message here.⌘I
curl -X DELETE 'https://api.cloud.blnkfinance.com/alerts/statuses/PENDING_REVIEW' \
-H 'Authorization: Bearer YOUR_API_KEY'
{
"message": "Status deleted"
}