layout | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
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.
{% swagger src="https://connect.getseam.com/openapi.json" path="/thermostats/heat_cool" method="post" %} https://connect.getseam.com/openapi.json {% endswagger %}
{% tabs %} {% tab title="Curl" %}
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
}'
{% endtab %} {% endtabs %}
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. |
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.
{% tabs %} {% tab title="JSON" %}
{
"action_attempt": {
"status": "pending",
"action_type": "SET_HEAT_COOL",
"action_attempt_id": "22222222-2222-2222-2222-222222222222",
"result": null,
"error": null
},
"ok": true
}
{% endtab %} {% endtabs %}