ChangeThermostatSettings

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

HTTP Basic

OAuth 2.0

API Key

Reset

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...