diff --git a/docs/capability-guides/thermostats/creating-and-managing-thermostat-schedules.md b/docs/capability-guides/thermostats/creating-and-managing-thermostat-schedules.md index ba25d468a..a3f206934 100644 --- a/docs/capability-guides/thermostats/creating-and-managing-thermostat-schedules.md +++ b/docs/capability-guides/thermostats/creating-and-managing-thermostat-schedules.md @@ -10,7 +10,7 @@ Once you have created a set of [climate presets](creating-and-managing-climate-p Each thermostat schedule can contain the following properties: -
PropertyDescription
name(Optional) User-friendly name to identify the thermostat schedule.
climate_preset_key(Required) Key of the climate preset to use for the thermostat schedule.
is_override_allowed(Optional) Indicates whether a person at the thermostat or using the API can change (that is, override) the thermostat's settings from an active scheduled climate preset.
max_override_period_minutesNumber of minutes for which a person at the thermostat or using the API can change (that is, override) the thermostat's settings after the activation of the scheduled climate preset.
Note: If you set this value to 0, the override applies until another climate preset becomes active, that is, the override timeout is disabled.
Default: 0
See also Specifying Manual Override Permissions.
starts_at(Required) Date and time at which the thermostat schedule starts, in ISO 8601 format.
ends_at(Required) Date and time at which the thermostat schedule ends, in ISO 8601 format.
+
PropertyDescription
name(Optional) User-friendly name to identify the thermostat schedule.
climate_preset_key(Required) Key of the climate preset to use for the thermostat schedule.
is_override_allowed(Optional) Indicates whether a person at the thermostat or using the API can change (that is, override) the thermostat's settings from an active scheduled climate preset.
max_override_period_minutesNumber of minutes for which a person at the thermostat or using the API can change (that is, override) the thermostat's settings after the activation of the scheduled climate preset.
Note: If you set this value to null, there is no enforced maximum override period. That is, the override applies until another climate preset becomes active.
Default: null
See also Specifying Manual Override Permissions.
starts_at(Required) Date and time at which the thermostat schedule starts, in ISO 8601 format.
ends_at(Required) Date and time at which the thermostat schedule ends, in ISO 8601 format.
*** @@ -30,7 +30,7 @@ When creating a schedule for a thermostat, you can specify `is_override_allowed` Through these override period settings, the Seam API provides you with the flexibility to customize the thermostat behavior to suit your needs. For example, a multifamily property manager may want to give complete control of the thermostat to a unit's residents as soon as they move into the unit. However, a short-term rental host may want to enforce stricter rules to ensure that their guests are using the associated HVAC system in a reasonable manner. -To allow complete control at the thermostat, set `is_override_allowed` to `true` and `max_override_period_minutes` to `0`. To disable manual overrides entirely, set `is_override_allowed` to `false`. +To allow complete control at the thermostat, set `is_override_allowed` to `true` and `max_override_period_minutes` to `null`. To disable manual overrides entirely, set `is_override_allowed` to `false`. ***