Skip to main content

Update metadata to a unit card

Service endpoint are subject to change

Method Description#

Update metadata to a given unit card.


Metadata key must be unique per organization within the same unit card

For more information, Metadata model

HTTP Request#


URL Parameters#

unit_card_id required#


The id of the unit card to be retrieved. This must be in string format compliant with ObjectId format.


An ObjectId is a 12-byte unique identifier consisting of:

A 4-byte value representing the seconds since the Unix epoch, a 5-byte random value, a 3-byte counter, starting with a random value.

Body Parameters#

key required#


Metadata key that will act as identifier of the resource within the unt card. Unique per organization and unit card.

value required#


Content of the metadata resource for the unit card. Content can be any type of data, String, Integer, Array, JSON object, etc...

metaType optional#


NO_TYPE by default

Set of predefined states used to identify easily certain metadata resources from a unit card. For more information see, Metadata Types.

visibility optional#


PUBLIC by default

Set of predefined states used to keep certain metadata resources locked to be only seen by owner and organization that created the resource. For more information see, Metadata Visibility.

Sample Code#

Payload example#

"key": "metadata_key",
"value": "updated value as string format"
"key": "MSRPPrice",
"value": [80, "USD"],
"metaType": "PRICE"
"key": "metdata_key_2",
"value": 30
url = ""
response = requests.request("PUT", url, headers=headers, data=payload)


Returns an array of Metadata objects.