Alerts
Update alert
Update the details of an existing alert.
PUT
/
alerts
/
flag
/
{alert_id}
curl -X PUT 'https://api.cloud.blnkfinance.com/alerts/flag/ano_8a380fd1-0289-46d1-bc76-aa17a510a64e' \
-H 'X-blnk-key: CLOUD_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"
}'
{
"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": []
}
Update an existing alert to modify its details, add context, or reflect workflow progression.
Prefer
/alerts. /anomalies is a legacy alias with the same alerts:read and alerts:write scopes.Authorization
Blnk Cloud APIs support any one of the following authentication methods. All of them work with yourCLOUD_API_KEY or OAUTH_ACCESS_TOKEN.
Pass X-blnk-key: CLOUD_API_KEY or X-blnk-key: OAUTH_ACCESS_TOKEN.
Path
curl -X PUT 'https://api.cloud.blnkfinance.com/alerts/flag/ano_8a380fd1-0289-46d1-bc76-aa17a510a64e' \
-H 'X-blnk-key: CLOUD_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"
}'
string
required
Unique identifier of the alert you want to update. Must be a valid alert ID.
Body
string
Updated title for the alert.
string
Updated description of the alert.
string
Updated status of the alert.
Response
{
"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": []
}
string
Unique identifier for the alert.
string
The updated title of the alert, if provided.
string
The updated description of the alert.
string
The type or category of the alert (e.g., “Balance”, “Transaction”, “Identity”).
string
The name or identifier of the user assigned to handle the alert.
array
Array of user identifiers to whom the alert has been escalated.
string
The current status of the alert (e.g., “FLAGGED”).
timestamp
ISO 8601 formatted timestamp of when the alert was created.
timestamp
ISO 8601 formatted timestamp of when the alert was last updated.
array
Array of balance IDs affected by this alert.
array
Array of identity IDs affected by this alert.
array
Array of transaction IDs affected by this alert.
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.Was this page helpful?
⌘I
curl -X PUT 'https://api.cloud.blnkfinance.com/alerts/flag/ano_8a380fd1-0289-46d1-bc76-aa17a510a64e' \
-H 'X-blnk-key: CLOUD_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"
}'
{
"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": []
}