> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blnkfinance.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete alert status

> Delete a custom alert status by key.

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

<RequestExample>
  ```bash cURL theme={"system"}
  curl -X DELETE 'https://api.cloud.blnkfinance.com/alerts/statuses/PENDING_REVIEW' \
    -H 'Authorization: Bearer YOUR_API_KEY'
  ```
</RequestExample>

<ParamField path="key" type="string" required>
  The status key to delete (e.g. PENDING\_REVIEW). Case-insensitive.
</ParamField>

### Response structure

<ResponseExample>
  ```json Success theme={"system"}
  {
    "message": "Status deleted"
  }
  ```
</ResponseExample>

<ResponseField name="message" type="string" required>
  Confirmation message when the status is deleted.
</ResponseField>

### 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:

<ResponseExample>
  ```json Error theme={"system"}
  {
    "error": "cannot delete status: 3 alert(s) use this status — reassign them to another status first"
  }
  ```
</ResponseExample>

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](mailto:support@blnkfinance.com) or [join our Discord community](https://discord.gg/7WNv94zPpx).

**Need help with your product?**

Get dedicated support for architecture reviews, integration planning, ledger workflows, and production deployment.