Overview

Metadata allows you to attach custom information to various ledger components, including ledgers, balances, identities, and transactions.

With the Update Metadata endpoint, you can modify existing metadata or add new metadata to an item after it has been created.

How it works

1

Initial metadata

Consider the following metadata attached to an item:

{
  ...
  "meta_data": {
    "first_name": "Jason"
  }
}
2

Adding more metadata

To add a last name and verification status, send a POST request to:

POST YOUR_BLNK_INSTANCE_URL/{id}/metadata
Request
{
  "meta_data": {
    "last_name": "Brooks",
    "verification_status": "Pending"
  }
}
3

Updating metadata

To update the verification status, send the following request:

POST YOUR_BLNK_INSTANCE_URL/{id}/metadata
Request
{
  "meta_data": {
    "verification_status": "Approved"
  }
}
4

Final metadata

After these updates, the metadata for the item will look like this:

{
  ...
  "meta_data": {
    "first_name": "Jason"
  }
}

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.

Get access to Blnk Cloud.

Manage your Blnk Ledger and explore advanced features (access control & collaboration, anomaly detection, secure storage & file management, etc.) in one dashboard.