Skip to main content
PUT
/
balance-monitors
/
{monitor_id}
Update balance monitor
curl --request PUT \
  --url http://localhost:5001/balance-monitors/{monitor_id} \
  --header 'X-blnk-key: <api-key>'
import requests

url = "http://localhost:5001/balance-monitors/{monitor_id}"

headers = {"X-blnk-key": "<api-key>"}

response = requests.put(url, headers=headers)

print(response.text)
const options = {method: 'PUT', headers: {'X-blnk-key': '<api-key>'}};

fetch('http://localhost:5001/balance-monitors/{monitor_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_PORT => "5001",
CURLOPT_URL => "http://localhost:5001/balance-monitors/{monitor_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_HTTPHEADER => [
"X-blnk-key: <api-key>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "http://localhost:5001/balance-monitors/{monitor_id}"

req, _ := http.NewRequest("PUT", url, nil)

req.Header.Add("X-blnk-key", "<api-key>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.put("http://localhost:5001/balance-monitors/{monitor_id}")
.header("X-blnk-key", "<api-key>")
.asString();
require 'uri'
require 'net/http'

url = URI("http://localhost:5001/balance-monitors/{monitor_id}")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Put.new(url)
request["X-blnk-key"] = '<api-key>'

response = http.request(request)
puts response.read_body
Use blnk.balance_monitor.update to update a balance monitor.
1

Call the method

blnk.balance_monitor.update
response = blnk.balance_monitor.update(
  "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",
  },
)
FieldTypeDescription
idstrMonitor ID to update.
balance_idstrBalance to monitor.
conditiondictThreshold rule with field, operator, value, and precision.
condition.fieldstrBalance field to watch (for example credit_balance, debit_balance, balance).
condition.operatorstrComparison operator: >, <, =, !=, >=, <=.
condition.valuenumberThreshold amount.
condition.precisionnumberCurrency precision (for example 100 for cents).
call_back_urlstrWebhook URL when the condition is met.
descriptionstrOptional description for the monitor.
2

Confirm the update

On success, Core returns a confirmation message. Fetch the monitor with get balance monitor to verify the new condition and webhook URL.
3

Response

200 OK
{
  "message": "BalanceMonitor updated successfully"
}
FieldTypeDescription
messagestrConfirmation from Core.

Balance monitoring

Conditions and webhook behavior.

Update balance monitor

HTTP request and response schema.

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.