Context
Change Type: Feature
Product area: Application enablement & solutions
Component: Digital Twin Manager
Deployed at: eu.latest.cumulocity.com, apj.cumulocity.com, jp.cumulocity.com, cumulocity.com, us.cumulocity.com, emea.cumulocity.com
Technical details
Build artifact: dtm (1024.4.0)
Description
When an asset links to a measurement source on a device, the platform maintains a reverse index (c8y_LinkedSeriesReverseIndex) on the device that tracks which assets reference it. Previously, if this index became out of sync with the asset-side configuration, there was no dedicated API endpoint to correct it.
The Digital Twin Manager REST API now includes a new endpoint to reconcile the opposite ChildAddition of a LinkedSeries (also known as MeasurementSourceLink): PUT /assets/{assetId}/linkedSeries/{fragment}/{series}/opposite. The endpoint updates the c8y_LinkedSeriesReverseIndex managed object on the device side to accurately reflect the asset-side source reference. The optional query parameter removeMissingSourceId removes the source.id if the linked device no longer exists. If the device is not found and the parameter is not set, the endpoint returns a 422 error.
Developers and administrators can use this endpoint to programmatically correct synchronization issues in linked data point configurations without manual intervention.