Skip to main content

Update a Primary VDT

PATCH 

/v1/vdt/:entityId

Updates an existing Primary VDT by its ID. Use this API to change attribute values or related VDT settings.

Details :

  • Requires the Primary VDT ID in the path and a valid registryId in the body.
  • Optional referenceInfo binds WHAT-section REFERENCE attributes only: each key is the attribute slug, each value is the referenced Primary VDT entityId. OVDT (WHO) and DVDT (DEVICE) references are derived from the authenticated org and device — do not send them in referenceInfo.
  • Set options.mint to true when on-chain minting is required.
  • On success, retrieve the latest state using the Get API.

Request​

Responses​

Primary VDT updated successfully.

Webhook Events

This API can trigger the following webhook events. Subscribe to them in the webhook event reference to receive real-time notifications.

VDT_MINTED
VDT Minted
Fired after primary mint is finalized on-chain. Routed to the Primary instance orgId (skipped if missing).
Full event reference