Creating and Managing Climate Presets
Learn how to create, list, update, and delete climate presets for thermostats.
Last updated
Was this helpful?
Learn how to create, list, update, and delete climate presets for thermostats.
Last updated
Was this helpful?
You create a set of climate presets for each thermostat, customized for your—and your users'—needs. Each climate preset is a predefined configuration for a thermostat that specifies settings, such as HVAC mode, fan mode, and temperature set points. These presets make it quick and efficient for users to apply consistent climate settings tailored to different scenarios, enhancing both comfort and energy efficiency.
Once you create climate presets, you can , add them to thermostat and , and set them as the .
Each climate preset can contain the following properties, depending on the of the thermostat:
climate_preset_key
(Required) Key to identify the climate preset.
name
(Optional) User-friendly name to identify the climate preset.
fan_mode_setting
Desired fan mode setting, such as on
, auto
, or circulate
.
hvac_mode_setting
cooling_set_point_celsius
cooling_set_point_fahrenheit
Temperature to which the thermostat should cool (in °F).
heating_set_point_celsius
Temperature to which the thermostat should heat (in °C).
heating_set_point_fahrenheit
Temperature to which the thermostat should heat (in °F).
manual_override_allowed
(Optional) Indicates whether a person at the thermostat or using the API can change the thermostat's settings.
Deprecated. Use thermostat_schedule.is_override_allowed
instead.
can_edit
Indicates whether the climate preset can be edited. There are some cases in which Seam syncs in climate presets (from the device) that cannot be modified.
can_delete
Indicates whether the climate preset can be deleted. There are some cases in which Seam syncs in climate presets (from the device) that cannot be deleted.
The following example creates two climate presets with the keys occupied
and unoccupied
:
Request:
Response:
Request:
Response:
Request:
Response:
Request:
Response:
Desired setting, such as heat
, cool
, heat_cool
, or off
.
Temperature to which the thermostat should cool (in °C). See also .
To create a climate preset, issue a request, providing the device_id
of the desired thermostat. Also, include the desired settings for the climate preset and, optionally, a name.
To list climate presets for a thermostat, issue a request, providing the device_id
of the desired thermostat. Then, inspect the available_climate_presets
property.
To update a climate preset, issue a request, providing the device_id
of the thermostat and the climate_preset_key
of the desired climate preset. Also, include the desired updated settings for the climate preset.
To delete a climate preset, issue a request, providing the device_id
of the thermostat and the climate_preset_key
of the desired climate preset.