Upsert Twins

Upsert Twin deletes an existing Digital Twin and recreates it from scratch with new values. The same operation also allows adding Feeds and Inputs with Metadata in a single call to streamline the process and reduce the number of API calls.

Introduction to Upsert Digital Twins

Upsert Twin allows, in this order, to:

  1. Delete the Twin
  2. Create the Twin
  3. Update the Twin
  4. Add Feeds and Inputs with Metadata

❗️

Be careful with the use of the Upsert Twin. It will delete and re-create the Twin only with the values specified in the body of the request.

The body parameters required to use the Upsert Twin API are the same as for Update Twin API in addition to the ones described in the table below.

KeyDescription
Twin DIDThe DID of the Twin that you want to upsert.

Mandatory
FeedsThe list of Feeds you want to add to the Twin including:

- the Feed(s) metadata;
- the Value(s) metadata.Optional
InputsThe list of Inputs you want to add to the Twin including:

- the Input(s) metadata;
- the Value(s) metadata.Optional