Tenant Mode

What is tenant mode, and how to use it.

Overview

Tenant mode is a concept within SmartBuildings whereby a thermostat can be registered in SmartBuildings and the ecobee Residential Portal at the same time.

This allows for a model where a property manager can allow a tenant of a residence to be able to register a thermostat in the residential portal, and control it as if they were a regular residential user, while a the same time allowing the property manager to continue having an overview of the thermostat.

Additionally, the property manager can still set a schedule for the thermostat and control it like normal when there is no tenant in residence.

Usage

Putting a thermostat into tenant mode will allow a user of the ecobee Residential Portal to register and control the thermostat.

Taking a thermostat out of tenant mode will disable the ability to register and control the thermostat from the ecobee Residential Portal. Additionally it will reset most of the settings on the thermostat back to the defaults, so that the tenant's settings are cleared out.

curl --request POST \
  --header "Authorization: Bearer <insert jwt token>" \
  --header "Content-type: application/json" \
  --url "https://api.sb.ecobee.com/api/v1/thermostats/<thermosstat id>" \
  --data '{ "isTenantMode": true }'
curl --request POST \
  --header "Authorization: Bearer <insert jwt token>" \
  --header "Content-type: application/json" \
  --url "https://api.sb.ecobee.com/api/v1/thermostats/<thermosstat id>" \
  --data '{ "isTenantMode": false }'

Upcoming Features of Tenant Mode

Currently when a thermostat is in tenant mode, the tenant in residence will have full control of the thermostat. This includes renaming the thermostat, changing alert levels, changing wifi settings, etc.

In the future we will be offering much more fine grained controls of what a tenant user of a SmartBuildings thermostat can do on the thermostat.


Did this page help you?