New Thermostat Endpoints

Grab a Scarf! The New Seam Thermostat Endpoints Just Dropped

This week, we're excited to release a preview of the new thermostats API, improving existing functionality, as well as introducing new features such as climate presets! Note that final functionality is still subject to change so check with us first before launching this to a ton of users.

Why New Endpoints

Our previous thermostats API did a great job of retrieving thermostat data and enabling you to perform imperative commands, such as switching a thermostat to heat mode. However, we realized it needed a more intuitive and flexible interface for climate preset and scheduling. It also didn’t handle prioritization of overlapping scheduled climate presets, as well as reverting to a fallback preset.

This new and improved API now addresses all these, letting you create a set of reusable climate presets for a thermostat and then schedule these climate presets, by name, as needed.

New Thermostats API Endpoints

We've added or improved the following endpoints:

• Get thermostats: Retrieve and monitor your users’ thermostats using /thermostats/list and /devices/get. The Seam API returns robust, up-to-date information about your connected thermostats.
• Imperative endpoints: Perform immediate changes to your users’ thermostats using “imperative” endpoints, such as /thermostats/heat, /thermostats/cool, /thermostats/set_fan_mode, and so on.
• [New] Create climate presets: Use /thermostats/create_climate_preset to create named climate presets, such as “occupied,” “eco,” “unoccupied,” “vacation mode,” and so on. Each preset can be configured with a specific operating mode (e.g. auto) and temperature.
• [New] Flexible climate schedules: Schedule the climate presets that you have created, using /thermostats/schedules/create. Simply specify the preset climate name—that is, the climate_preset_key—along with starts_at and ends_at timestamps and the maximum override period. You can also set a fallback climate preset.

Feedback and Next Steps

Because this release is a preview, we encourage you to try it out using the Seam CLI and give us your feedback. Note that we're also developing new capability flags for thermostats. Stay tuned for relevant announcements soon!

2024.09.20 Changelog

Changed

• More Schlage sandbox device accounts: Added more sandbox device accounts for Schlage.

Fixes

• TTLock capabilities detection: Fixed an issue in which TTLock devices with keypads were incorrectly reporting a lack of access code support.
• SmartThings device refresh token detection: Improved automatic detection of failing refresh tokens. Instead of silently failing, Seam now correctly prompts the account owner to reauthenticate using a Connect Webview.
• Dormakaba Oracode device reconnection: Fixed an issue that incorrectly disconnected Dormakaba Oracode accounts on reconnection.