Create a Climate Preset

POST /thermostats/create_climate_preset ⇒ void

Creates a climate preset for a specified thermostat.

JavaScript

Request

await seam.thermostats.createClimatePreset({
  device_id: "123e4567-e89b-12d3-a456-426614174000",
  climate_preset_key: "occupied",
  name: "Occupied",
  fan_mode_setting: "auto",
  hvac_mode_setting: "heat_cool",
  cooling_set_point_celsius: 25,
  heating_set_point_celsius: 20,
  manual_override_allowed: true,
});

Response

// void

Python

Request

seam.thermostats.create_climate_preset(
    device_id="123e4567-e89b-12d3-a456-426614174000",
    climate_preset_key="occupied",
    name="Occupied",
    fan_mode_setting="auto",
    hvac_mode_setting="heat_cool",
    cooling_set_point_celsius=25,
    heating_set_point_celsius=20,
    manual_override_allowed=true,
)

Response

None

Ruby

Request

seam.thermostats.create_climate_preset(
  device_id: "123e4567-e89b-12d3-a456-426614174000",
  climate_preset_key: "occupied",
  name: "Occupied",
  fan_mode_setting: "auto",
  hvac_mode_setting: "heat_cool",
  cooling_set_point_celsius: 25,
  heating_set_point_celsius: 20,
  manual_override_allowed: true,
)

Response

nil

PHP

Request

<?php
$seam->thermostats->create_climate_preset(
    device_id: "123e4567-e89b-12d3-a456-426614174000",
    climate_preset_key: "occupied",
    name: "Occupied",
    fan_mode_setting: "auto",
    hvac_mode_setting: "heat_cool",
    cooling_set_point_celsius: 25,
    heating_set_point_celsius: 20,
    manual_override_allowed: true
);

Response

null

Seam CLI

Request

seam thermostats create-climate-preset --device_id "123e4567-e89b-12d3-a456-426614174000" --climate_preset_key "occupied" --name "Occupied" --fan_mode_setting "auto" --hvac_mode_setting "heat_cool" --cooling_set_point_celsius 25 --heating_set_point_celsius 20 --manual_override_allowed true

Response

{}

Go

Request

package main

import api "github.com/seamapi/go"

func main() {
	client.Thermostats.CreateClimatePreset(
		context.Background(),
		api.ThermostatsCreateClimatePresetRequest{
			DeviceId:               api.String("123e4567-e89b-12d3-a456-426614174000"),
			ClimatePresetKey:       api.String("occupied"),
			Name:                   api.String("Occupied"),
			FanModeSetting:         api.String("auto"),
			HvacModeSetting:        api.String("heat_cool"),
			CoolingSetPointCelsius: api.Float64(25),
			HeatingSetPointCelsius: api.Float64(20),
			ManualOverrideAllowed:  api.Bool(true),
		},
	)
}

Response

nil

Authentication Methods

• API key

• Client session token

• Personal access token Must also include the seam-workspace header in the request.

Request Parameters

climate_preset_key

Format: String Required: Yes

Unique key to identify the climate preset.

---

device_id

Format: UUID Required: Yes

ID of the desired thermostat device.

---

cooling_set_point_celsius

Format: Number Required: No

Temperature to which the thermostat should cool (in °C). See also Set Points.

---

cooling_set_point_fahrenheit

Format: Number Required: No

Temperature to which the thermostat should cool (in °F). See also Set Points.

---

fan_mode_setting

Format: Enum Required: No

Desired fan mode setting, such as on, auto, or circulate.

Possible enum values:

• auto

• on

• circulate

---

heating_set_point_celsius

Format: Number Required: No

Temperature to which the thermostat should heat (in °C). See also Set Points.

---

heating_set_point_fahrenheit

Format: Number Required: No

Temperature to which the thermostat should heat (in °F). See also Set Points.

---

hvac_mode_setting

Format: Enum Required: No

Desired HVAC mode setting, such as heat, cool, heat_cool, or off.

Possible enum values:

• off

• heat

• cool

• heat_cool

---

manual_override_allowed

Format: Boolean Required: No

Indicates whether a person at the thermostat or using the API can change the thermostat's settings.

Deprecated. Use 'thermostat_schedule.is_override_allowed'

---

name

Format: String Required: No

User-friendly name to identify the climate preset.

---

Return Type

void