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

# Managing Alerts

> Create and manage alerts programmatically using the Cloud APIs.

The Alerts API enables you to create, retrieve, update, and manage alerts programmatically within your application. This allows you to integrate alerting capabilities directly into your workflows, automate monitoring, and trigger alerts based on application logic or external events.

While you can create alerts manually through the Blnk Cloud dashboard, the API provides the flexibility to build alerting into your application's core functionality.

***

## Create alerts

Create a new alert by flagging a balance, transaction, or identity.

Send a POST request to the `/alerts/flag/{id}` endpoint, where `{id}` is the identifier of the entity you want to flag.

<CodeGroup>
  ```bash Request wrap theme={"system"}
  curl -X POST 'https://api.cloud.blnkfinance.com/alerts/flag/bal_1234567890abcdef' \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    -d '{
      "title": "Balance threshold exceeded",
      "description": "Account balance has exceeded the maximum allowed limit."
    }'
  ```

  ```json Response wrap theme={"system"}
  {
    "anomaly_id": "ano_8a380fd1-0289-46d1-bc76-aa17a510a64e",
    "title": "Balance threshold exceeded",
    "description": "Account balance has exceeded the maximum allowed limit.",
    "type": "Balance",
    "assigned_to": "jerrys enebeli",
    "escalated_to": [
      "user_01K4EX0BRXHNNGCRVT2TPNK07W"
    ],
    "status": "FLAGGED",
    "created_at": "2026-01-15T09:22:37.55763+01:00",
    "updated_at": "2026-01-15T09:22:37.55763+01:00",
    "affected_balances": [
      "bln_20f02af6-3728-4d37-9b5a-c7ed080f09df"
    ],
    "affected_identities": [],
    "affected_transactions": []
  }
  ```
</CodeGroup>

***

## Update alerts

Modify alert details, update status, or add additional context after investigation.

<CodeGroup>
  ```bash Request wrap theme={"system"}
  curl -X PUT 'https://api.cloud.blnkfinance.com/alerts/flag/ano_8a380fd1-0289-46d1-bc76-aa17a510a64e' \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    -d '{
      "title": "Balance threshold exceeded - Resolved",
      "description": "Account balance has been adjusted and is now within acceptable limits."
    }'
  ```

  ```json Response wrap theme={"system"}
  {
    "anomaly_id": "ano_8a380fd1-0289-46d1-bc76-aa17a510a64e",
    "title": "Balance threshold exceeded - Resolved",
    "description": "Account balance has been adjusted and is now within acceptable limits.",
    "type": "Balance",
    "assigned_to": "jerrys enebeli",
    "escalated_to": [
      "user_01K4EX0BRXHNNGCRVT2TPNK07W"
    ],
    "status": "FLAGGED",
    "created_at": "2026-01-15T09:22:37.55763+01:00",
    "updated_at": "2026-01-15T10:15:42.123456+01:00",
    "affected_balances": [
      "bln_20f02af6-3728-4d37-9b5a-c7ed080f09df"
    ],
    "affected_identities": [],
    "affected_transactions": []
  }
  ```
</CodeGroup>

***

## Get alerts

Fetch a specific alert by ID or retrieve all alerts in your workspace.

<CodeGroup>
  ```bash Request wrap theme={"system"}
  # Get all alerts
  curl -X GET 'https://api.cloud.blnkfinance.com/alerts' \
    -H 'Authorization: Bearer YOUR_API_KEY'

  # Get specific alert by ID
  curl -X GET 'https://api.cloud.blnkfinance.com/alerts/ano_8a380fd1-0289-46d1-bc76-aa17a510a64e' \
    -H 'Authorization: Bearer YOUR_API_KEY'
  ```

  ```json Response wrap theme={"system"}
  {
    "anomaly_id": "ano_8a380fd1-0289-46d1-bc76-aa17a510a64e",
    "title": "Balance threshold exceeded",
    "description": "Account balance has exceeded the maximum allowed limit.",
    "type": "Balance",
    "assigned_to": "jerrys enebeli",
    "escalated_to": [
      "user_01K4EX0BRXHNNGCRVT2TPNK07W"
    ],
    "status": "FLAGGED",
    "created_at": "2026-01-15T09:22:37.55763+01:00",
    "updated_at": "2026-01-15T09:26:03.094425+01:00",
    "affected_balances": [
      "bln_20f02af6-3728-4d37-9b5a-c7ed080f09df"
    ],
    "affected_identities": [],
    "affected_transactions": []
  }
  ```
</CodeGroup>

***

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