Set to Heat-Cool (Auto) Mode
Set a thermostat to heat-cool mode, also known as "auto" mode. To do so, you must include both cooling and heating set points in the payload, either in Celsius or Fahrenheit. For information about verifying the heating and cooling availability of the thermostat and validating the correct set points, see HVAC Mode Constraints and Set Point Constraints.
Sets a specified thermostat to heat-cool ("auto") mode.
ID of the thermostat device that you want to set to heat-cool mode.
Heating set point in °C that you want to set for the thermostat. You must set one of the heating_set_point
parameters.
Heating set point in °F that you want to set for the thermostat. You must set one of the heating_set_point
parameters.
Cooling set point in °C that you want to set for the thermostat. You must set one of the cooling_set_point
parameters.
Cooling set point in °F that you want to set for the thermostat. You must set one of the cooling_set_point
parameters.
false
POST /thermostats/heat_cool HTTP/1.1
Host: connect.getseam.com
Authorization: Bearer Client Session Token
Content-Type: application/json
Accept: */*
Content-Length: 191
{
"device_id": "123e4567-e89b-12d3-a456-426614174000",
"heating_set_point_celsius": 1,
"heating_set_point_fahrenheit": 1,
"cooling_set_point_celsius": 1,
"cooling_set_point_fahrenheit": 1,
"sync": false
}
{
"action_attempt": {
"action_attempt_id": "123e4567-e89b-12d3-a456-426614174000",
"status": "pending",
"result": null,
"error": null,
"action_type": "LOCK_DOOR"
},
"ok": true
}
Code Example
curl --request POST 'https://connect.getseam.com/thermostats/heat_cool' \
--header 'Authorization: Bearer ${API_KEY}' \
--header 'Content-Type: application/json' \
--header 'Seam-Workspace: 00000000-0000-0000-0000-000000000000' \
--data-raw '{
"device_id": "11111111-1111-1111-1111-111111111111",
"cooling_set_point_celsius": 25,
"heating_set_point_celsius": 20
}'
Parameters
device_id
type: string
ID of the Device of the thermostat
cooling_set_point_celsius
type: number
Optional
Temperature the thermostat should cool to (in °C). You must set one of the cooling_set_point
parameters.
cooling_set_point_fahrenheit
type: number
Optional
Temperature the thermostat should cool to (in °F). You must set one of the cooling_set_point
parameters.
heating_set_point_celsius
type: number
Optional
Temperature the thermostat should heat to (in °C).
You must set one of the heating_set_point
parameters.
heating_set_point_fahrenheit
type: number
Optional
Temperature the thermostat should heat to (in °F).
You must set one of the heating_set_point
parameters.
Response
This section shows the JSON response returned by the API. Since each language encapsulates this response inside objects specific to that language and/or implementation, the actual type in your language might differ from what’s written here.
JSON format
{
"action_attempt": {
"status": "pending",
"action_type": "SET_HEAT_COOL",
"action_attempt_id": "22222222-2222-2222-2222-222222222222",
"result": null,
"error": null
},
"ok": true
}
Last updated
Was this helpful?