POST
Change Thermostat Settings
Change the setpoint, system mode, and auto changeover status of a thermostat. Take care to track current consumer setting for AutoChangeover so it's not disabled or enabled unintentionally.
Homeywell Home T-Series devices also have the capability of a 7-day schedule as well as geofencing. When sending a setpoint change request you have a few options:
- "NoHold" - This will set the device to run the current schedule
- "TemporaryHold" - No "nextPeriodTime" is required, the thermostat will hold the temperature until the next schedule period change.
- "PermanentHold" - This will hold the setpoint until the next consumer interation.
- "HoldUntil" - Requires a "nextPeriodTime" value, the thermostat will hold the requested setpoint(s) until that time.
Example for TCC device:
{ "mode": "Cool", "autoChangeoverActive": true, "heatSetpoint": 72, "coolSetpoint": 74 }
Example for LCC device:
{ "mode": "Heat", "heatSetpoint": 62, "coolSetpoint": 80, "thermostatSetpointStatus": "TemporaryHold" }
Field Name/Location | Data Type | Definition |
---|---|---|
Mode | String | Mode to set to, must match available modes. Heat, Cool, Off |
AutoChangeoverActive | Boolean | If field is set in the response then the thermostat supports autochangeover to be controlled independent of mode. If field is not set in the response then the thermostat does not support autochangeover to be controlled independent of mode and you must look into AllowedModes to see it the thermostat supports at least autochangeover controllable by mode. |
EmergencyHeatActive | Boolean | Indicates if emergency heating is active. Do not send if Emergency Heat is false. |
HeatSetpoint | Decimal | New value for heat setpoint. Whole numbers for F and half increments for C units. |
CoolSetpoint | Decimal | New value for cool setpoint. Whole numbers for F and half increments for C units. |
thermostatSetpointStatus | String | For "LCC-" devices only. "NoHold" will return to schedule. "TemporaryHold" will hold the set temperature until "nextPeriodTime". "PermanentHold" will hold the setpoint until user requests another change. |
nextPeriodTime | String | For "LCC-" devices only. Format must be in "hh:mm:ss" in 15 minute increments. Example: "18:00:00" |
Resource URL
https://api.honeywell.com/v2 /devices/thermostats/{deviceId}
Query Parameters
Name | Values | Description |
---|---|---|
apikey
(required) |
Your API Key |
|
locationId
(required) |
LocationID for the requested device |
Request Body
deviceId DeviceID for the requested device true
Make a request and see the response.
Make a request and see the response.
Make a request and see the response.
Resource Summary |
|
Security |
|
Content Type |
application/json |
Category |
Thermostat |
Working...