July 9, 2026 - Alarm upsert endpoint changes

Context


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

Technical details

Build artifact: cumulocity (2026.211.0)
Internal ID: MTM-67007

Description


The POST /alarm/alarms/upsert endpoint has been updated with the following changes:

  • New response body: The endpoint now returns an object with two fields instead of a plain alarm representation:
    alarm (the alarm as it exists after the upsert) and previousState
    (a snapshot of the alarm before the upsert, or null if a new alarm was created).
  • New query parameter: A boolean incrementCount parameter (default: false) has been added.
    When set to true, the count property of an existing alarm is incremented during upsert.

For details refer to the alarm upsert operation
in the Cumulocity OpenAPI Specification.

1 Like