Ledger balances
Update balance monitor
Update the details of a balance monitor with the Go SDK.
PUT
/balance-monitors/{monitor_id}Use client.BalanceMonitor.Update to update a balance monitor.
Call the method
monitor, _, _ := client.BalanceMonitor.Update(
"mon_e0e77b0c-4985-472a-9bf5-76a48b0259b0",
blnkgo.MonitorData{
BalanceID: "bln_5ce86029-3c2e-4e2a-aae2-7fb931ca4c4f",
Condition: blnkgo.MonitorCondition{
Field: "credit_balance",
Operator: blnkgo.OperatorLessThan,
Value: 500,
Precision: 100,
},
CallBackURL: "https://api.example.com/balance-monitor",
},
)
| Field | Type | Description |
|---|---|---|
monitorID | string | Monitor ID to update. |
BalanceID | string | Balance to monitor. |
Condition | MonitorCondition | Threshold rule with Field, Operator, Value, and Precision. |
Condition.Field | string | Balance field to watch (for example credit_balance, debit_balance, balance). |
Condition.Operator | MonitorConditionOperators | Comparison operator: >, <, =, !=, >=, <=. |
Condition.Value | int64 | Threshold amount. |
Condition.Precision | int64 | Currency precision (for example 100 for cents). |
CallBackURL | string | Webhook URL when the condition is met. |
Description | string | Optional description for the monitor. |
Response
{
"monitor_id": "mon_e0e77b0c-4985-472a-9bf5-76a48b0259b0",
"balance_id": "bln_5ce86029-3c2e-4e2a-aae2-7fb931ca4c4f",
"condition": {
"field": "credit_balance",
"operator": "<",
"value": 500,
"precision": 100
},
"call_back_url": "https://api.example.com/balance-monitor",
"created_at": "2024-02-20T05:56:58.257315054Z"
}Go response (*blnkgo.MonitorDataResp)
| Field | Type | Description |
|---|---|---|
MonitorID | string | Unique ID for the monitor. |
BalanceID | string | Balance being monitored. |
Condition | MonitorCondition | Updated threshold rule. |
CallBackURL | string | Webhook URL for notifications. |
CreatedAt | string | Date and time when the monitor was created. |