October 30, 2025 - Measurement series aggregation improvements

Cumulocity Change Log Platform services
, ,
1

Context

Change Type: Feature
Product area: Platform services
Component: REST API
Deployed at: eu.latest.cumulocity.com, apj.cumulocity.com, jp.cumulocity.com, cumulocity.com, us.cumulocity.com, emea.cumulocity.com

Technical details

Build artifact: cumulocity (2025.356.0)
Internal ID: MTM-64669

Description

A new query parameter aggregationFunction has been added to the measurement series endpoint. This parameter allows to specify
aggregation functions to be calculated on the measurement series data per specified aggregation interval.
The supported aggregation functions are: min, max, avg, sum, count, stdDevPop, and stdDevSamp.
If the parameter is not provided, the functions min and max will be calculated by default.

Info
If you want to calculate multiple functions at once, you must specify the parameter multiple times, for example,
aggregationFunction=min&aggregationFunction=max&aggregationFunction=avg.

Caution
This parameter can only be specified when an aggregation interval is provided using aggregationType or aggregationInterval parameter.
Providing the aggregationFunction parameter without an aggregation interval will result in a bad request error.
This parameter only takes effect for the timeseries persistence of measurements.
For legacy persistence, the min and max functions are always calculated.