Setting the Time of the Last Measuring Point Reset with API

Measuring Points can be used as counters that continuously increase their values (e.g., number of operating hours or machine cycles). Breakpoints – limits that trigger predefined actions in the system (such as notifications or maintenance interventions) – can be defined on these Measuring Points.

To ensure correct functioning of breakpoints, it is essential to record the time of the last Measuring Point reset. A reset means that the Measuring Point value is set to zero and starts increasing again. If the time of the last reset is not updated, breakpoints could incorrectly evaluate historical data prior to the reset and trigger unintended actions.

The time of the last reset can be set directly in the application, but for integration with external systems it is also possible to set the reset time via API.

Identifying Required IDs

For an API call, the following identifiers are needed:

Equipment ID – displayed in the URL when editing equipment.
Example: .../equipments/1666 → equipment_id is 1666.
KPI Definition ID (Measuring Point ID) – displayed in the URL when editing a specific Measuring Point in the application. Example: .../measuring-point/341 → idKpiDefinition is 341.

API volání

Method: POST
Endpoint:

CODE

{{host}}/equipment/{equipment_id}/actions/set-kpi-definition

Request Body Example

CODE

{
  "kpiDefinitions": [
    {
      "idKpiDefinition": 341,
      "timeLastMPReset": "2025-09-01T05:51:49+00:00"
    }
  ]
}

Parameter Description

idKpiDefinition – ID of the Measuring Point for which the reset time is being set.
timeLastMPReset – time of the last reset in UTC format (YYYY-MM-DDTHH:mm:ss+00:00)

Practical Example

For equipment with Equipment ID 1666 and Measuring Point TV-MP, the time of the last reset can be set to 1 September 2025, 05:51:49 UTC using the request above in Postman

Recommendations

Always enter the Measuring Point reset time in UTC format to avoid inconsistencies between systems.
After performing a reset, verify in the application that the Measuring Point value has been reset to zero.
If equipment contains multiple Measuring Points, an API call must be executed separately for each Measuring Point.

This guide complements the documentation Sending Measuring Point data with API and enables management of Measuring Point reset times when integrating with external systems.