Update alert

PUT

alerts

flag

{alert_id}

curl -X PUT 'https://api.cloud.blnkfinance.com/alerts/flag/ano_8a380fd1-0289-46d1-bc76-aa17a510a64e' \
  -H 'Authorization: Bearer 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 your CLOUD_API_KEY or OAUTH_ACCESS_TOKEN.

Bearer token
X-Blnk-Key header
X-API-Key header

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.

Pass X-Blnk-Key: CLOUD_API_KEY or X-Blnk-Key: OAUTH_ACCESS_TOKEN.

string

required

Cloud API key or OAuth access token. Create credentials in API keys or OAuth.

Pass X-API-Key: CLOUD_API_KEY or X-API-Key: OAUTH_ACCESS_TOKEN.

string

required

Cloud API key or OAuth access token. Create credentials in API keys or OAuth.

Path

curl -X PUT 'https://api.cloud.blnkfinance.com/alerts/flag/ano_8a380fd1-0289-46d1-bc76-aa17a510a64e' \
  -H 'Authorization: Bearer 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.

curl -X PUT 'https://api.cloud.blnkfinance.com/alerts/flag/ano_8a380fd1-0289-46d1-bc76-aa17a510a64e' \
  -H 'Authorization: Bearer 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": []
}

Start Here

Deployments

Proxy & data

Data lake

AI integrations

Audit

Alerts

Billing

Authorization

Path

Body

Response

Need help?

​Authorization

​Path

​Body

​Response

​Need help?

Authorization

Path

Body

Response

Need help?