April 9, 2026 - Asset API now handles device groups as assets and offers the includeGroups query parameter

Change Log Application Enablement
, ,
1

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 (1025.0.0)
Internal ID: CTM-2772

Description

The Asset API has been changed to treat groups as assets. Previously, an
asset was identified solely by the presence of the c8y_IsAsset fragment.
Now, the presence of c8y_IsDeviceGroup is also sufficient
to classify an entity as an asset.

A new query parameter includeGroups (default: false) has been
introduced for the /assets and /assets/count endpoints:

  • When set to true, the results include entities with either c8y_IsAsset or
    c8y_IsDeviceGroup.
  • When set to false, the results are limited to entities with c8y_IsAsset only.