May 13, 2026 - New endpoint to get direct subassets for an asset identified by its external ID

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

Technical details

Build artifact: dtm (1025.4.0)
Internal ID: CTM-2900

Description


The Dtm microservice now includes a new endpoint
/assets/externalIds/{externalId}/subAssets that allows you to fetch
direct subassets using an asset’s external ID. Previously, you could
only retrieve subassets by using the asset’s ID, which required an
additional lookup step if you were working with external identifiers.
This new endpoint streamlines workflows by enabling direct queries based
on external IDs, eliminating the need for intermediate ID resolution.

With this addition, applications and integrations that manage assets
through external identifiers can now access subasset hierarchies more
efficiently. Your existing code using internal IDs continues to work
without changes, and you can adopt the new endpoint at your own pace to
improve performance and reduce complexity in asset management
operations.