September 14, 2026 - Add withSubAssets parameter to sub-asset assignment endpoint

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

Technical details

Build artifact: dtm (1025.12.0)
Internal ID: CTM-3204

Description


The subasset assignment endpoint now provides a withSubAssets query parameter to optimize response handling. Previously, assignment operations always returned the entire subasset collection for the parent object, which caused performance issues when parents had large numbers of subassets or child devices requiring multiple inventory reads.

With this change, you can now control whether the parent’s full subasset collection is included in the response by setting the withSubAssets parameter. This allows you to skip the costly expansion of the subasset collection when you don’t need this information, improving performance for assignments on parents with large subasset hierarchies.

Existing integrations continue to work without changes, as the parameter is optional and maintains backward-compatible behavior by default. Applications managing assets with extensive subasset relationships benefit from faster response times when performing assignments.