Skip to main content
POST
/
{id}
/
metadata
Update metadata
curl --request POST \
  --url http://localhost:5001/{id}/metadata \
  --header 'X-blnk-key: <api-key>'
import requests

url = "http://localhost:5001/{id}/metadata"

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

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

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

fetch('http://localhost:5001/{id}/metadata', 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/{id}/metadata",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
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/{id}/metadata"

req, _ := http.NewRequest("POST", 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.post("http://localhost:5001/{id}/metadata")
.header("X-blnk-key", "<api-key>")
.asString();
require 'uri'
require 'net/http'

url = URI("http://localhost:5001/{id}/metadata")

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

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

response = http.request(request)
puts response.read_body
Use blnk.metadata.update to add or change metadata on an existing ledger, transaction, balance, or identity.
1

Call the method

blnk.metadata.update
response = blnk.metadata.update(
  "ldg_073f7ffe-9dfd-42ce-aa50-d1dca1788adc",
  {
    "meta_data": {
      "project_owner": "Acme LLC",
      "update_status": "Approved",
    },
  },
)
FieldTypeDescription
idstrID of the entity to update (ldg_…, txn_…, bln_…, or idt_…).
data.meta_datadictKey-value pairs to add or update on the entity.
2

Use the updated metadata

Read response.data["meta_data"] for the full metadata object after the update. New keys are merged with existing metadata.
3

Response

201 Created
{
  "meta_data": {
    "project_owner": "Acme LLC",
    "update_status": "Approved"
  }
}
FieldTypeDescription
meta_datadictThe full metadata object after the update.

How metadata works

Attaching custom attributes to Blnk objects.

Update metadata

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.