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.

​
Authorization

Blnk Cloud APIs support any one of the following authentication methods. All of them work with your CLOUD_API_KEY or OAUTH_ACCESS_TOKEN.
Pass Authorization: Bearer CLOUD_API_KEY or Authorization: Bearer OAUTH_ACCESS_TOKEN.
​
string
required
Cloud API key or OAuth access token. Create credentials in API keys or OAuth.

​
Path

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

​
Response

​
string
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.