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

# Update alert

> Update the details of an existing alert.

Update an existing alert to modify its details, add context, or reflect workflow progression.

***

### Request structure

<RequestExample>
  ```bash cURL 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": "An identity has been flagged in a sanction list.",
      "description": "this is a test from an update",
      "status": "PENDING_REVIEW"
    }'
  ```
</RequestExample>

<ParamField path="alert_id" type="string" required>
  Unique identifier of the alert you want to update. Must be a valid alert ID.
</ParamField>

<ParamField body="title" type="string">
  Updated title for the alert.
</ParamField>

<ParamField body="description" type="string">
  Updated description of the alert.
</ParamField>

<ParamField body="status" type="string">
  Updated status of the alert.
</ParamField>

***

### Response structure

<ResponseExample>
  ```json Success theme={"system"}
  {
    "anomaly_id": "ano_8a380fd1-0289-46d1-bc76-aa17a510a64e",
    "title": "An identity has been flagged in a sanction list.",
    "description": "this is a test from an update",
    "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": []
  }
  ```
</ResponseExample>

<ResponseField name="anomaly_id" type="string" required>
  Unique identifier for the alert.
</ResponseField>

<ResponseField name="title" type="string">
  The updated title of the alert, if provided.
</ResponseField>

<ResponseField name="description" type="string" required>
  The updated description of the alert.
</ResponseField>

<ResponseField name="type" type="string" required>
  The type or category of the alert (e.g., "Balance", "Transaction", "Identity").
</ResponseField>

<ResponseField name="assigned_to" type="string">
  The name or identifier of the user assigned to handle the alert.
</ResponseField>

<ResponseField name="escalated_to" type="array">
  Array of user identifiers to whom the alert has been escalated.
</ResponseField>

<ResponseField name="status" type="string" required>
  The current status of the alert (e.g., "FLAGGED").
</ResponseField>

<ResponseField name="created_at" type="timestamp" required>
  ISO 8601 formatted timestamp of when the alert was created.
</ResponseField>

<ResponseField name="updated_at" type="timestamp" required>
  ISO 8601 formatted timestamp of when the alert was last updated.
</ResponseField>

<ResponseField name="affected_balances" type="array" required>
  Array of balance IDs affected by this alert.
</ResponseField>

<ResponseField name="affected_identities" type="array" required>
  Array of identity IDs affected by this alert.
</ResponseField>

<ResponseField name="affected_transactions" type="array" required>
  Array of transaction IDs affected by this alert.
</ResponseField>

***

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