Events
thermostat.climate_preset_activated
A thermostat climate preset was activated.
Propertiesclimate_preset_key
String
Key of the climate preset that was activated.
connected_account_id
UUID
ID of the connected account associated with the event.
created_at
Datetime
Date and time at which the event was created.
device_id
UUID
ID of the affected device.
event_id
UUID
ID of the event.
event_type
Enum
Value: thermostat.climate_preset_activated
is_fallback_climate_preset
Boolean
Indicates whether the climate preset that was activated is the fallback climate preset for the thermostat.
occurred_at
Datetime
Date and time at which the event occurred.
thermostat_schedule_id
UUID
ID of the thermostat schedule that prompted the affected climate preset to be activated.
workspace_id
UUID
ID of the workspace associated with the event.
thermostat.manually_adjusted
A thermostat was adjusted manually.
Propertiesconnected_account_id
UUID
ID of the connected account associated with the event.
cooling_set_point_celsius
Number
Temperature to which the thermostat should cool (in °C). See also Set Points .
cooling_set_point_fahrenheit
Number
Temperature to which the thermostat should cool (in °F). See also Set Points .
created_at
Datetime
Date and time at which the event was created.
device_id
UUID
ID of the affected device.
event_id
UUID
ID of the event.
event_type
Enum
Value: thermostat.manually_adjusted
fan_mode_setting
Enum
Desired fan mode setting , such as on
, auto
, or circulate
.
heating_set_point_celsius
Number
Temperature to which the thermostat should heat (in °C). See also Set Points .
heating_set_point_fahrenheit
Number
Temperature to which the thermostat should heat (in °F). See also Set Points .
hvac_mode_setting
Enum
Desired HVAC mode setting, such as heat
, cool
, heat_cool
, or off
.
method
Enum
Method used to adjust the affected thermostat manually. seam
indicates that the Seam API, Seam CLI, or Seam Console was used to adjust the thermostat.
occurred_at
Datetime
Date and time at which the event occurred.
workspace_id
UUID
ID of the workspace associated with the event.
thermostat.temperature_threshold_exceeded
A thermostat's temperature reading exceeded the set threshold .
Propertiesconnected_account_id
UUID
ID of the connected account associated with the event.
created_at
Datetime
Date and time at which the event was created.
device_id
UUID
ID of the affected device.
event_id
UUID
ID of the event.
event_type
Enum
Value: thermostat.temperature_threshold_exceeded
lower_limit_celsius
Number
Lower temperature limit, in °C, defined by the set threshold.
lower_limit_fahrenheit
Number
Lower temperature limit, in °F, defined by the set threshold.
occurred_at
Datetime
Date and time at which the event occurred.
temperature_celsius
Number
Temperature, in °C, reported by the affected thermostat.
temperature_fahrenheit
Number
Temperature, in °F, reported by the affected thermostat.
upper_limit_celsius
Number
Upper temperature limit, in °C, defined by the set threshold.
upper_limit_fahrenheit
Number
Upper temperature limit, in °F, defined by the set threshold.
workspace_id
UUID
ID of the workspace associated with the event.
thermostat.temperature_threshold_no_longer_exceeded
A thermostat's temperature reading no longer exceeds the set threshold .
Propertiesconnected_account_id
UUID
ID of the connected account associated with the event.
created_at
Datetime
Date and time at which the event was created.
device_id
UUID
ID of the affected device.
event_id
UUID
ID of the event.
event_type
Enum
Value: thermostat.temperature_threshold_no_longer_exceeded
lower_limit_celsius
Number
Lower temperature limit, in °C, defined by the set threshold.
lower_limit_fahrenheit
Number
Lower temperature limit, in °F, defined by the set threshold.
occurred_at
Datetime
Date and time at which the event occurred.
temperature_celsius
Number
Temperature, in °C, reported by the affected thermostat.
temperature_fahrenheit
Number
Temperature, in °F, reported by the affected thermostat.
upper_limit_celsius
Number
Upper temperature limit, in °C, defined by the set threshold.
upper_limit_fahrenheit
Number
Upper temperature limit, in °F, defined by the set threshold.
workspace_id
UUID
ID of the workspace associated with the event.
thermostat.temperature_reached_set_point
A thermostat's temperature reading is within 1 °C of the configured cooling or heating set point .
Propertiesconnected_account_id
UUID
ID of the connected account associated with the event.
created_at
Datetime
Date and time at which the event was created.
desired_temperature_celsius
Number
Desired temperature, in °C, defined by the affected thermostat's cooling or heating set point.
desired_temperature_fahrenheit
Number
Desired temperature, in °F, defined by the affected thermostat's cooling or heating set point.
device_id
UUID
ID of the affected device.
event_id
UUID
ID of the event.
event_type
Enum
Value: thermostat.temperature_reached_set_point
occurred_at
Datetime
Date and time at which the event occurred.
temperature_celsius
Number
Temperature, in °C, reported by the affected thermostat.
temperature_fahrenheit
Number
Temperature, in °F, reported by the affected thermostat.
workspace_id
UUID
ID of the workspace associated with the event.
thermostat.temperature_changed
A thermostat's reported temperature changed by at least 1 °C.
Propertiesconnected_account_id
UUID
ID of the connected account associated with the event.
created_at
Datetime
Date and time at which the event was created.
device_id
UUID
ID of the affected device.
event_id
UUID
ID of the event.
event_type
Enum
Value: thermostat.temperature_changed
occurred_at
Datetime
Date and time at which the event occurred.
temperature_celsius
Number
Temperature, in °C, reported by the affected thermostat.
temperature_fahrenheit
Number
Temperature, in °F, reported by the affected thermostat.
workspace_id
UUID
ID of the workspace associated with the event.
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 .
/thermostats/update_weekly_program
Updates the thermostat weekly program for a thermostat device. To configure a weekly program, specify the ID of the daily program that you want to use for each day of the week. When you update a weekly program, the set of programs that you specify overwrites any previous weekly program for the thermostat.