You can configure Seam to emit a if a thermostat reports a temperature outside a specific threshold range. This capability helps you to monitor your thermostats proactively, alerting you to potential HVAC system misuse or malfunctioning.
Use the endpoint to set upper and lower acceptable temperature bounds. Then, you can use a to monitor for thermostat.temperature_threshold_exceeded events.
When the thermostat reports a temperature outside the threshold range, Seam also adds a warning on the thermostat. You can use the endpoint to get the thermostat and then inspect its device.warnings property.
Set a Temperature Threshold
To set a temperature threshold for a thermostat, issue a request, providing the device_id of the desired thermostat. Also, include the following parameters:
When the reported temperature for a thermostat returns to within the configured threshold range, Seam emits a thermostat.temperature_threshold_no_longer_exceeded event.
Delete a Temperature Threshold
To delete the temperature threshold range for a thermostat, issue a /thermostats/set_temperature_threshold request, providing either of the following parameter combinations:
Provide only the device_id of the desired thermostat.
Provide the device_id of the desired thermostat and set the following parameters to null:
The temperature threshold range that you set for a thermostat is a property of the resource itself. To view the threshold values, use the endpoint and inspect the thermostat.temperature_threshold.
To change the temperature threshold range for a thermostat, issue a new request. The new threshold values replace the previous ones.
To monitor a thermostat for temperatures outside the bounds of the configured threshold range, you can configure a to receive thermostat.temperature_threshold_exceeded events. This event includes the device_id of the affected thermostat, as well as the configured threshold values and the reported temperature that exceeded this threshold range.
