Introduction

This guide outlines the upcoming updated specifications for the GET /power-thresholds/config endpoint, which is an integral part of the Real-Time Power Alerts functionality.

• For objects where no thresholds are defined, the response included an empty array "[ ]" in place of the object itself. In the current solution example below, phase_2 and phase_3 objects are empty arrays as they do not include any thresholds.
• The new solution excludes any objects that do not contain thresholds from the response entirely.

In the below responses you may find the current solution and respectively the upcoming changes.

Current solution

{
    "status": "ok",
    "data": {
        "mains": {
            "threshold_0": {
                "enabled": true,
                "threshold_value": 400,
                "alert_type": "upper",
                "cooldown": 60,
                "aggregation_method": "mean",
                "aggregation_sample_count": 10,
                "aggregation_sample_interval": 10,
                "last_updated": "2024-12-20T11:36:18"
            },
            "threshold_1": {
                "enabled": true,
                "threshold_value": 1000,
                "alert_type": "upper",
                "cooldown": 60,
                "aggregation_method": "mean",
                "aggregation_sample_count": 10,
                "aggregation_sample_interval": 10,
                "last_updated": "2024-12-20T11:36:18"
            }
        },
        "phase_1": {
            "threshold_0": {
                "enabled": true,
                "threshold_value": 120,
                "alert_type": "upper",
                "cooldown": 60,
                "aggregation_method": "mean",
                "aggregation_sample_count": 10,
                "aggregation_sample_interval": 10,
                "last_updated": "2024-12-20T11:36:18"
            }
        },
        "phase_2": [],
        "phase_3": []
    }
}

Upcoming changes

{
    "status": "ok",
    "data": {
        "mains": {
            "threshold_0": {
                "enabled": true,
                "threshold_value": 400,
                "alert_type": "upper",
                "cooldown": 60,
                "aggregation_method": "mean",
                "aggregation_sample_count": 10,
                "aggregation_sample_interval": 10,
                "last_updated": "2024-12-20T11:36:18"
            },
            "threshold_1": {
                "enabled": true,
                "threshold_value": 1000,
                "alert_type": "upper",
                "cooldown": 60,
                "aggregation_method": "mean",
                "aggregation_sample_count": 10,
                "aggregation_sample_interval": 10,
                "last_updated": "2024-12-20T11:36:18"
            }
        },
        "phase_1": {
            "threshold_0": {
                "enabled": true,
                "threshold_value": 120,
                "alert_type": "upper",
                "cooldown": 60,
                "aggregation_method": "mean",
                "aggregation_sample_count": 10,
                "aggregation_sample_interval": 10,
                "last_updated": "2024-12-20T11:36:18"
            }
        }
    }
}