Skip to main content
Available in version 0.8.2 and later.

​
Overview

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
cURL
curl -X POST "http://localhost:5001/{id}/metadata" \
  -H "X-blnk-key: <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "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
cURL
curl -X POST "http://localhost:5001/{id}/metadata" \
  -H "X-blnk-key: <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "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",
    "last_name": "Brooks",
    "verification_status": "Approved"
  }
}

​
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.
Tip: Connect to Blnk Cloud to see your Core data.You can view your transactions, manage identities, create custom reports, invite other team members to collaborate, and perform operations on your Core — all in one dashboard.Check out Blnk Cloud →
⌘I