New Set HVAC Mode Endpoint

This week, we’ve added a new thermostat endpoint, and we want your opinion. At Seam, we’re fervently committed to making it easier to develop your IoT app. We saw an opportunity to make an aspect of our thermostats API more ergonomic, so we jumped at the chance to give you more choices and to meet your needs better!

In our original implementation, you could set the HVAC mode of a thermostat using any of the following four separate “imperative” endpoints:

/thermostats/heat
/thermostats/cool
/thermosats/heat_cool
/thermostats/off

Then, we realized that some developers might find it more efficient to use a single endpoint—/thermostats/set_hvac_mode.

We’re introducing a preview of this new endpoint in our HTTP API and in our JavaScript, Python, Ruby, and PHP SDKs. We invite you to try it out and let us know what you think.

(Don’t worry, though. We’re not deprecating the existing four imperative endpoints. We’ve just added the new one.)

The following JavaScript example shows you how to use this new endpoint:

JavaScript
1// Get the thermostat.
2const thermostat = await seam.devices.get({
3  device_id: "bad6d447-f847-4672-94a9-5992398d0272"
4});
5
6// Confirm that the thermostat supports the desired mode.
7if (thermostat.can_hvac_heat) {
8  // Set the HVAC mode.
9  await seam.thermostats.setHvacMode({
10    device_id: thermostat.device_id,
11    hvac_mode_setting: "heat",
12    heating_set_point_celsius: 20
13  })
14};

2024.11.26 Changelog

New

Akiles webhooks: We added webhook support for Akiles lock.unlocked and lock.locked events.

Changed

Warning for Nest thermostats in manual eco mode: You cannot perform imperative actions—such as setting the HVAC mode to heat—on Google Nest thermostats that are in manual eco mode. Consequently, we now emit a nest_thermostat_in_manual_eco_mode warning on the affected device.
Workspaces displayed in alphabetical order: The Seam Console workspace picker now displays the list of your workspaces in alphabetical order.

Fixes

Add missing device capability flag: We corrected an issue in which specific locks with Yale Smart Modules were missing the can_program_online_access_codes capability flag.
Improve handling for Nuki outages: To handle these intermittent outages more elegantly, we now try to refresh the affected Nuki devices instead of just marking them as disconnected.
Device warnings displayed twice in Seam Console: We corrected an issue in which the Warnings area was displayed twice on the Seam Console Device page.

New Set HVAC Mode Endpoint