Thermostats

Endpoints

/thermostats/activate_climate_preset

Activates a specified climate preset for a specified thermostat.

/thermostats/cool

Sets a specified thermostat to cool mode.

/thermostats/create_climate_preset

Creates a climate preset for a specified thermostat.

/thermostats/delete_climate_preset

Deletes a specified climate preset for a specified thermostat.

/thermostats/heat

Sets a specified thermostat to heat mode.

/thermostats/heat_cool

Sets a specified thermostat to heat-cool ("auto") mode.

/thermostats/list

Returns a list of all thermostats.

/thermostats/off

Sets a specified thermostat to "off" mode.

/thermostats/set_fallback_climate_preset

Sets a specified climate preset as the "fallback" preset for a specified thermostat.

/thermostats/set_fan_mode

Sets the fan mode setting for a specified thermostat.

/thermostats/set_hvac_mode

Sets the HVAC mode for a specified thermostat.

/thermostats/set_temperature_threshold

Sets a temperature threshold for a specified thermostat. Seam emits a thermostat.temperature_threshold_exceeded event and adds a warning on a thermostat if it reports a temperature outside the threshold range.

/thermostats/update_climate_preset

Updates a specified climate preset for a specified thermostat.

Events

thermostat.climate_preset_activated

A thermostat climate preset was activated.

thermostat_schedule_id string

ID of the [thermostat schedule](../../capability-guides/thermostats/creating-and-managing-thermostat-schedules/README.md) that prompted the [climate preset](../../capability-guides/thermostats/creating-and-managing-climate-presets/README.md) to be activated.

climate_preset_key string

Key of the [climate preset](../../capability-guides/thermostats/creating-and-managing-climate-presets) that was activated.

is_fallback_climate_preset boolean

Indicates whether the [climate preset](../..capability-guides/thermostats/creating-and-managing-climate-presets/README.md) that was activated is the [fallback climate preset](../../capability-guides/thermostats/creating-and-managing-climate-presets/setting-the-fallback-climate-preset) for the thermostat.

---

thermostat.thermostat_manually_adjusted_event

A thermostat was adjusted manually.

method enum

Method used to adjust the thermostat manually. `seam` indicates that the Seam API, Seam CLI, or Seam Console was used to adjust the thermostat.

Possible enum values:

• seam

• external

---

thermostat.temperature_threshold_exceeded

A thermostat's temperature reading exceeded the set threshold.

temperature_celsius number

Temperature, in °C, reported by the thermostat.

temperature_fahrenheit number

Temperature, in °F, reported by the thermostat.

upper_limit_celsius number

Upper temperature limit, in °C, defined by the set [threshold](../../capability-guides/thermostats/setting-and-monitoring-temperature-thresholds).

upper_limit_fahrenheit number

Upper temperature limit, in °F, defined by the set [threshold](../../capability-guides/thermostats/setting-and-monitoring-temperature-thresholds).

lower_limit_celsius number

Lower temperature limit, in °C, defined by the set [threshold](../../capability-guides/thermostats/setting-and-monitoring-temperature-thresholds).

lower_limit_fahrenheit number

Lower temperature limit, in °F, defined by the set [threshold](../../capability-guides/thermostats/setting-and-monitoring-temperature-thresholds).

---

thermostat.temperature_threshold_no_longer_exceeded

A thermostat's temperature reading no longer exceeds the set threshold.

temperature_celsius number

Temperature, in °C, reported by the thermostat.

temperature_fahrenheit number

Temperature, in °F, reported by the thermostat.

upper_limit_celsius number

Upper temperature limit, in °C, defined by the set [threshold](../../capability-guides/thermostats/setting-and-monitoring-temperature-thresholds).

upper_limit_fahrenheit number

Upper temperature limit, in °F, defined by the set [threshold](../../capability-guides/thermostats/setting-and-monitoring-temperature-thresholds).

lower_limit_celsius number

Lower temperature limit, in °C, defined by the set [threshold](../../capability-guides/thermostats/setting-and-monitoring-temperature-thresholds).

lower_limit_fahrenheit number

Lower temperature limit, in °F, defined by the set [threshold](../../capability-guides/thermostats/setting-and-monitoring-temperature-thresholds).

---