Ask or search…
K
Links
Comment on page

Set to Heat Mode

Set a thermostat to heating mode. To do so, you must include a heating set point in the payload, either in Celsius or Fahrenheit. For information about verifying the heating availability of the thermostat and validating the correct set points, see HVAC Mode Constraints and Set Point Constraints.
post
https://connect.getseam.com
/thermostats/heat
/thermostats/heat

Code Example

Curl
curl --request POST 'https://connect.getseam.com/thermostats/heat' \
--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",
"heating_set_point_celsius": 25
}'

Parameters

device_id
type: string
ID of the Device of the thermostat
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

JSON
{
"action_attempt": {
"status": "pending",
"action_type": "SET_HEAT",
"action_attempt_id": "22222222-2222-2222-2222-222222222222",
"result": null,
"error": null
},
"ok": true
}