Thermostats

The device Object for Thermostats

You can use the Seam API to perform the following management and monitoring actions for thermostats:

Monitor current thermostat settings and readings.
Configure temperature thresholds. If the thermostat reports a temperature outside these thresholds, Seam automatically alerts you.
Make immediate changes to thermostat climate settings, such as the HVAC mode and fan mode.
Create and schedule climate presets, including a fallback climate preset.
Create daily and weekly thermostat programs.

The Seam API represents a thermostat as a device resource that includes both basic device properties and thermostat-specific properties.

A thermostat device resource.

{
  "can_hvac_cool": true,
  "can_hvac_heat": true,
  "can_hvac_heat_cool": true,
  "can_turn_off_hvac": true,
  "capabilities_supported": ["thermostat"],
  "connected_account_id": "a0b1c2d3-e4f5-6a7b-8c9d-0e1f2a3b4c5d",
  "created_at": "2024-10-03T22:12:15.666Z",
  "custom_metadata": { "id": "internalId1" },
  "device_id": "a1b2c3d4-e5f6-7890-1234-56789abcdef0",
  "device_type": "ecobee_thermostat",
  "display_name": "Living Room",
  "errors": [],
  "is_managed": true,
  "space_ids": [],
  "location": {
    "location_name": "2948 20th St, San Francisco, CA, 94110, US",
    "timezone": "America/Los_Angeles"
  },
  "nickname": "Living Room",
  "properties": {
    "active_climate_preset": {
      "can_delete": true,
      "can_edit": true,
      "climate_preset_key": "sleep",
      "cooling_set_point_celsius": 23.88888888888889,
      "display_name": "Sleep",
      "fan_mode_setting": "auto",
      "heating_set_point_celsius": 17.77777777777778,
      "hvac_mode_setting": "heat_cool",
      "manual_override_allowed": true
    },
    "appearance": { "name": "Living Room" },
    "available_climate_presets": [
      {
        "climate_preset_key": "sleep",
        "can_edit": true,
        "can_delete": true,
        "can_use_with_thermostat_daily_programs": false,
        "name": "Sleep",
        "display_name": "Sleep",
        "fan_mode_setting": "auto",
        "hvac_mode_setting": "heat_cool",
        "manual_override_allowed": true,
        "cooling_set_point_celsius": 23.88888888888889,
        "heating_set_point_celsius": 17.77777777777778,
        "cooling_set_point_fahrenheit": 75,
        "heating_set_point_fahrenheit": 64
      },
      {
        "climate_preset_key": "home",
        "can_edit": true,
        "can_delete": true,
        "can_use_with_thermostat_daily_programs": false,
        "name": "Home",
        "display_name": "Home",
        "fan_mode_setting": "auto",
        "hvac_mode_setting": "heat_cool",
        "manual_override_allowed": false,
        "cooling_set_point_celsius": 23.88888888888889,
        "heating_set_point_celsius": 17.77777777777778,
        "cooling_set_point_fahrenheit": 75,
        "heating_set_point_fahrenheit": 64
      },
      {
        "climate_preset_key": "work",
        "can_edit": true,
        "can_delete": true,
        "can_use_with_thermostat_daily_programs": false,
        "name": "Work",
        "display_name": "Work",
        "fan_mode_setting": "auto",
        "hvac_mode_setting": "heat_cool",
        "manual_override_allowed": false,
        "cooling_set_point_celsius": 23.88888888888889,
        "heating_set_point_celsius": 17.77777777777778,
        "cooling_set_point_fahrenheit": 75,
        "heating_set_point_fahrenheit": 64
      }
    ],
    "available_fan_mode_settings": ["auto", "on"],
    "available_hvac_mode_settings": ["cool", "heat", "heat_cool", "off"],
    "current_climate_setting": {
      "display_name": "Manual Setting",
      "fan_mode_setting": "auto",
      "heating_set_point_celsius": 25,
      "heating_set_point_fahrenheit": 77,
      "hvac_mode_setting": "heat",
      "manual_override_allowed": true
    },
    "ecobee_metadata": {
      "device_name": "Living Room",
      "ecobee_device_id": "a1b2c3d4-e5f6-7890-1234-56789abcdef0"
    },
    "fallback_climate_preset_key": "eco",
    "fan_mode_setting": "auto",
    "has_direct_power": true,
    "image_alt_text": "Ecobee 3 Lite Thermostat",
    "image_url": "https://connect.getseam.com/_next/image?url=https://connect.getseam.com/assets/images/devices/ecobee_3-lite_front.png&q=75&w=128",
    "is_cooling": false,
    "is_fan_running": false,
    "is_heating": false,
    "is_temporary_manual_override_active": false,
    "manufacturer": "ecobee",
    "max_cooling_set_point_celsius": 33.333333333333336,
    "max_cooling_set_point_fahrenheit": 92,
    "max_heating_set_point_celsius": 26.11111111111111,
    "max_heating_set_point_fahrenheit": 79,
    "min_cooling_set_point_celsius": 18.333333333333336,
    "min_cooling_set_point_fahrenheit": 65,
    "min_heating_cooling_delta_celsius": 2.7777777777777777,
    "min_heating_cooling_delta_fahrenheit": 5,
    "min_heating_set_point_celsius": 7.222222222222222,
    "min_heating_set_point_fahrenheit": 45,
    "model": {
      "display_name": "Thermostat",
      "manufacturer_display_name": "Ecobee"
    },
    "name": "Living Room",
    "online": true,
    "relative_humidity": 0.36,
    "temperature_celsius": 21.11111111111111,
    "temperature_fahrenheit": 70,
    "temperature_threshold": {
      "lower_limit_celsius": 16.66666666666667,
      "lower_limit_fahrenheit": 62,
      "upper_limit_celsius": 26.66666666666667,
      "upper_limit_fahrenheit": 80
    },
    "thermostat_daily_programs": [
      {
        "thermostat_daily_program_id": "1a2b3c4d-5e6f-7890-1234-56789abcdef1",
        "device_id": "a1b2c3d4-e5f6-7890-1234-56789abcdef0",
        "name": "Weekday Program",
        "periods": [
          { "starts_at_time": "00:00:00", "climate_preset_key": "sleep" },
          { "starts_at_time": "07:00:00", "climate_preset_key": "home" },
          { "starts_at_time": "09:00:00", "climate_preset_key": "work" },
          { "starts_at_time": "18:00:00", "climate_preset_key": "home" },
          { "starts_at_time": "22:00:00", "climate_preset_key": "sleep" }
        ],
        "workspace_id": "9f8e7d6c-5b4a-3c2d-1e0f-9876543210ab",
        "created_at": "2025-05-30T04:01:25.455Z"
      },
      {
        "thermostat_daily_program_id": "d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f90",
        "device_id": "a1b2c3d4-e5f6-7890-1234-56789abcdef0",
        "name": "Weekend Program",
        "periods": [
          { "starts_at_time": "00:00:00", "climate_preset_key": "sleep" },
          { "starts_at_time": "08:00:00", "climate_preset_key": "home" },
          { "starts_at_time": "23:00:00", "climate_preset_key": "sleep" }
        ],
        "workspace_id": "9f8e7d6c-5b4a-3c2d-1e0f-9876543210ab",
        "created_at": "2025-05-30T04:02:19.952Z"
      }
    ],
    "thermostat_weekly_program": null
  },
  "warnings": [],
  "workspace_id": "9f8e7d6c-5b4a-3c2d-1e0f-9876543210ab"
}

Properties

can_hvac_cool Boolean

can_hvac_heat Boolean

can_hvac_heat_cool Boolean

can_program_offline_access_codes Boolean

can_program_online_access_codes Boolean

can_program_thermostat_programs_as_different_each_day Boolean

can_program_thermostat_programs_as_same_each_day Boolean

can_program_thermostat_programs_as_weekday_weekend Boolean

can_remotely_lock Boolean

can_remotely_unlock Boolean

can_run_thermostat_programs Boolean

can_simulate_connection Boolean

can_simulate_disconnection Boolean

can_simulate_hub_connection Boolean

can_simulate_hub_disconnection Boolean

can_simulate_paid_subscription Boolean

can_simulate_removal Boolean

can_turn_off_hvac Boolean

can_unlock_with_code Boolean

capabilities_supported List of Enums

Collection of capabilities that the device supports when connected to Seam. Values are access_code, which indicates that the device can manage and utilize digital PIN codes for secure access; lock, which indicates that the device controls a door locking mechanism, enabling the remote opening and closing of doors and other entry points; noise_detection, which indicates that the device supports monitoring and responding to ambient noise levels; thermostat, which indicates that the device can regulate and adjust indoor temperatures; battery, which indicates that the device can manage battery life and health; and phone, which indicates that the device is a mobile device, such as a smartphone. Important: Superseded by capability flags.

connected_account_id UUID

Unique identifier for the account associated with the device.

created_at Datetime

Date and time at which the device object was created.

custom_metadata Record

Set of key:value pairs. Adding custom metadata to a resource, such as a Connect Webview, connected account, or device, enables you to store custom information, like customer details or internal IDs from your application.

device_id UUID

ID of the device.

device_type Enum

Type of the device.

Enum values

akuvox_lock
august_lock
brivo_access_point
butterflymx_panel
avigilon_alta_entry
doorking_lock
genie_door
igloo_lock
linear_lock
lockly_lock
kwikset_lock
nuki_lock
salto_lock
schlage_lock
seam_relay
smartthings_lock
wyze_lock
yale_lock
two_n_intercom
controlbyweb_device
ttlock_lock
igloohome_lock
hubitat_lock
four_suites_door
dormakaba_oracode_door
tedee_lock
akiles_lock
ultraloq_lock
korelock_lock
keynest_key
noiseaware_activity_zone
minut_sensor
ecobee_thermostat
nest_thermostat
honeywell_resideo_thermostat
tado_thermostat
sensi_thermostat
smartthings_thermostat
ios_phone
android_phone

display_name String

Display name of the device, defaults to nickname (if it is set) or properties.appearance.name, otherwise. Enables administrators and users to identify the device easily, especially when there are numerous devices.

errors List of Objects

Array of errors associated with the device. Each error object within the array contains two fields: error_code and message. error_code is a string that uniquely identifies the type of error, enabling quick recognition and categorization of the issue. message provides a more detailed description of the error, offering insights into the issue and potentially how to rectify it.

The specific structure of each object in this list depends on the value of its error_code field.

Variants:

account_disconnected

Indicates that the account is disconnected.

created_at Datetime

Date and time at which Seam created the error.

error_code Enum

Unique identifier of the type of error. Enables quick recognition and categorization of the issue.

Enum values:

account_disconnected

is_connected_account_error Boolean

Indicates that the error is a connected account error.

is_device_error Boolean

Indicates that the error is not a device error.

message String

Detailed description of the error. Provides insights into the issue and potentially how to rectify it.

salto_ks_subscription_limit_exceeded

Indicates that the Salto site user limit has been reached.

created_at Datetime

Date and time at which Seam created the error.

error_code Enum

Unique identifier of the type of error. Enables quick recognition and categorization of the issue.

Enum values:

salto_ks_subscription_limit_exceeded

is_connected_account_error Boolean

Indicates that the error is a connected account error.

is_device_error Boolean

Indicates that the error is not a device error.

message String

Detailed description of the error. Provides insights into the issue and potentially how to rectify it.

device_offline

Indicates that the device is offline.

created_at Datetime

Date and time at which Seam created the error.

error_code Enum

Unique identifier of the type of error. Enables quick recognition and categorization of the issue.

Enum values:

device_offline

is_device_error Boolean

Indicates that the error is a device error.

message String

Detailed description of the error. Provides insights into the issue and potentially how to rectify it.

device_removed

Indicates that the device has been removed.

created_at Datetime

Date and time at which Seam created the error.

error_code Enum

Unique identifier of the type of error. Enables quick recognition and categorization of the issue.

Enum values:

device_removed

is_device_error Boolean

Indicates that the error is a device error.

message String

Detailed description of the error. Provides insights into the issue and potentially how to rectify it.

hub_disconnected

Indicates that the hub is disconnected.

created_at Datetime

Date and time at which Seam created the error.

error_code Enum

Unique identifier of the type of error. Enables quick recognition and categorization of the issue.

Enum values:

hub_disconnected

is_device_error Boolean

Indicates that the error is a device error.

message String

Detailed description of the error. Provides insights into the issue and potentially how to rectify it.

device_disconnected

Indicates that the device is disconnected.

created_at Datetime

Date and time at which Seam created the error.

error_code Enum

Unique identifier of the type of error. Enables quick recognition and categorization of the issue.

Enum values:

device_disconnected

is_device_error Boolean

Indicates that the error is a device error.

message String

Detailed description of the error. Provides insights into the issue and potentially how to rectify it.

empty_backup_access_code_pool

Indicates that the backup access code pool is empty.

created_at Datetime

Date and time at which Seam created the error.

error_code Enum

Unique identifier of the type of error. Enables quick recognition and categorization of the issue.

Enum values:

empty_backup_access_code_pool

is_device_error Boolean

Indicates that the error is a device error.

message String

Detailed description of the error. Provides insights into the issue and potentially how to rectify it.

august_lock_not_authorized

Indicates that the user is not authorized to use the August lock.

created_at Datetime

Date and time at which Seam created the error.

error_code Enum

Unique identifier of the type of error. Enables quick recognition and categorization of the issue.

Enum values:

august_lock_not_authorized

is_device_error Boolean

Indicates that the error is a device error.

message String

Detailed description of the error. Provides insights into the issue and potentially how to rectify it.

august_lock_missing_bridge

Indicates that the lock is not connected to a bridge.

created_at Datetime

Date and time at which Seam created the error.

error_code Enum

Unique identifier of the type of error. Enables quick recognition and categorization of the issue.

Enum values:

august_lock_missing_bridge

is_device_error Boolean

Indicates that the error is a device error.

message String

Detailed description of the error. Provides insights into the issue and potentially how to rectify it.

ttlock_lock_not_paired_to_gateway

Indicates that the lock is not paired with a gateway.

created_at Datetime

Date and time at which Seam created the error.

error_code Enum

Unique identifier of the type of error. Enables quick recognition and categorization of the issue.

Enum values:

ttlock_lock_not_paired_to_gateway

is_device_error Boolean

Indicates that the error is a device error.

message String

Detailed description of the error. Provides insights into the issue and potentially how to rectify it.

missing_device_credentials

Indicates that device credentials are missing.

created_at Datetime

Date and time at which Seam created the error.

error_code Enum

Unique identifier of the type of error. Enables quick recognition and categorization of the issue.

Enum values:

missing_device_credentials

is_device_error Boolean

Indicates that the error is a device error.

message String

Detailed description of the error. Provides insights into the issue and potentially how to rectify it.

auxiliary_heat_running

Indicates that the auxiliary heat is running.

created_at Datetime

Date and time at which Seam created the error.

error_code Enum

Unique identifier of the type of error. Enables quick recognition and categorization of the issue.

Enum values:

auxiliary_heat_running

is_device_error Boolean

Indicates that the error is a device error.

message String

Detailed description of the error. Provides insights into the issue and potentially how to rectify it.

subscription_required

Indicates that a subscription is required to connect.

created_at Datetime

Date and time at which Seam created the error.

error_code Enum

Unique identifier of the type of error. Enables quick recognition and categorization of the issue.

Enum values:

subscription_required

is_device_error Boolean

Indicates that the error is a device error.

message String

Detailed description of the error. Provides insights into the issue and potentially how to rectify it.

lockly_missing_wifi_bridge

Indicates that the Lockly lock is not connected to a Wi-Fi bridge.

created_at Datetime

Date and time at which Seam created the error.

error_code Enum

Unique identifier of the type of error. Enables quick recognition and categorization of the issue.

Enum values:

lockly_missing_wifi_bridge

is_device_error Boolean

Indicates that the error is a device error.

message String

Detailed description of the error. Provides insights into the issue and potentially how to rectify it.

bridge_disconnected

Indicates that the Seam API cannot communicate with Seam Bridge, for example, if the Seam Bridge executable has stopped or if the computer running the Seam Bridge executable is offline. See also Troubleshooting Your Access Control System.

created_at Datetime

Date and time at which Seam created the error.

error_code Enum

Unique identifier of the type of error. Enables quick recognition and categorization of the issue.

Enum values:

bridge_disconnected

is_bridge_error Boolean

Indicates whether the error is related to Seam Bridge.

is_connected_account_error Boolean

Indicates whether the error is related specifically to the connected account.

message String

Detailed description of the error. Provides insights into the issue and potentially how to rectify it.

is_managed Boolean

Indicates whether Seam manages the device. See also Managed and Unmanaged Devices.

nickname String

Optional nickname to describe the device, settable through Seam.

space_ids List of UUIDs

IDs of the spaces the device is in.

warnings List of Objects

Array of warnings associated with the device. Each warning object within the array contains two fields: warning_code and message. warning_code is a string that uniquely identifies the type of warning, enabling quick recognition and categorization of the issue. message provides a more detailed description of the warning, offering insights into the issue and potentially how to rectify it.

The specific structure of each object in this list depends on the value of its warning_code field.

Variants:

partial_backup_access_code_pool

Indicates that the backup access code is unhealthy.

created_at Datetime

Date and time at which Seam created the warning.

message String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

warning_code Enum

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.

Enum values:

partial_backup_access_code_pool

many_active_backup_codes

Indicates that there are too many backup codes.

created_at Datetime

Date and time at which Seam created the warning.

message String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

warning_code Enum

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.

Enum values:

many_active_backup_codes

wyze_device_missing_gateway

Indicates that the Wyze Lock is not connected to a gateway.

created_at Datetime

Date and time at which Seam created the warning.

message String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

warning_code Enum

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.

Enum values:

wyze_device_missing_gateway

third_party_integration_detected

Indicates that a third-party integration has been detected.

created_at Datetime

Date and time at which Seam created the warning.

message String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

warning_code Enum

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.

Enum values:

third_party_integration_detected

ttlock_lock_gateway_unlocking_not_enabled

Indicates that the Remote Unlock feature is not enabled in the settings."

created_at Datetime

Date and time at which Seam created the warning.

message String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

warning_code Enum

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.

Enum values:

ttlock_lock_gateway_unlocking_not_enabled

ttlock_weak_gateway_signal

Indicates that the gateway signal is weak.

created_at Datetime

Date and time at which Seam created the warning.

message String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

warning_code Enum

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.

Enum values:

ttlock_weak_gateway_signal

power_saving_mode

Indicates that the device is in power saving mode and may have limited functionality.

created_at Datetime

Date and time at which Seam created the warning.

message String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

warning_code Enum

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.

Enum values:

power_saving_mode

temperature_threshold_exceeded

Indicates that the temperature threshold has been exceeded.

created_at Datetime

Date and time at which Seam created the warning.

message String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

warning_code Enum

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.

Enum values:

temperature_threshold_exceeded

device_communication_degraded

Indicates that the device appears to be unresponsive.

created_at Datetime

Date and time at which Seam created the warning.

message String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

warning_code Enum

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.

Enum values:

device_communication_degraded

scheduled_maintenance_window

Indicates that a scheduled maintenance window has been detected.

created_at Datetime

Date and time at which Seam created the warning.

message String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

warning_code Enum

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.

Enum values:

scheduled_maintenance_window

device_has_flaky_connection

Indicates that the device has a flaky connection.

created_at Datetime

Date and time at which Seam created the warning.

message String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

warning_code Enum

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.

Enum values:

device_has_flaky_connection

salto_ks_office_mode

Indicates that the Salto KS lock is in Office Mode. Access Codes will not unlock doors.

created_at Datetime

Date and time at which Seam created the warning.

message String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

warning_code Enum

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.

Enum values:

salto_ks_office_mode

salto_ks_privacy_mode

Indicates that the Salto KS lock is in Privacy Mode. Access Codes will not unlock doors.

created_at Datetime

Date and time at which Seam created the warning.

message String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

warning_code Enum

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.

Enum values:

salto_ks_privacy_mode

salto_ks_subscription_limit_almost_reached

Indicates that the Salto KS site has exceeded 80% of the maximum number of allowed users. Increase your subscription limit or delete some users from your site.

created_at Datetime

Date and time at which Seam created the warning.

message String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

warning_code Enum

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.

Enum values:

salto_ks_subscription_limit_almost_reached

unknown_issue_with_phone

Indicates that an unknown issue occurred while syncing the state of the phone with the provider. This issue may affect the proper functioning of the phone.

created_at Datetime

Date and time at which Seam created the warning.

message String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

warning_code Enum

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.

Enum values:

unknown_issue_with_phone

lockly_time_zone_not_configured

Indicates that Seam detected that the Lockly device does not have a time zone configured. Time-bound codes may not work as expected.

created_at Datetime

Date and time at which Seam created the warning.

message String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

warning_code Enum

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.

Enum values:

lockly_time_zone_not_configured

ultraloq_time_zone_unknown

Indicates that Seam does not know the time zone of the Ultraloq device. Set a time zone to enable time-bound access codes.

created_at Datetime

Date and time at which Seam created the warning.

message String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

warning_code Enum

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.

Enum values:

ultraloq_time_zone_unknown

hub_required_for_additional_capabilities

Indicates that a hub or relay must be connected to unlock additional capabilities such as remote unlock.

created_at Datetime

Date and time at which Seam created the warning.

message String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

warning_code Enum

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.

Enum values:

hub_required_for_additional_capabilities

keynest_unsupported_locker

Indicates that the key is in a locker that does not support the access codes API.

created_at Datetime

Date and time at which Seam created the warning.

message String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

warning_code Enum

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.

Enum values:

keynest_unsupported_locker

accessory_keypad_setup_required

Indicates that the accessory keypad exists, but is not linked to the Igloohome Bridge. Online access code programming will fail until the keypad is linked to the Igloohome Bridge in the Igloohome app.

created_at Datetime

Date and time at which Seam created the warning.

message String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

warning_code Enum

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.

Enum values:

accessory_keypad_setup_required

workspace_id UUID

Unique identifier for the Seam workspace associated with the device.

device.properties

active_thermostat_schedule Object

Active thermostat schedule.

Deprecated. Use active_thermostat_schedule_id with /thermostats/schedules/get instead.

Child Properties

climate_preset_key String
Key of the climate preset to use for the thermostat schedule.
created_at Datetime
Date and time at which the thermostat schedule was created.
device_id UUID
ID of the desired thermostat device.
ends_at Datetime
Date and time at which the thermostat schedule ends, in ISO 8601 format.
errors List of Objects
Errors associated with the thermostat schedule.
error_code String
Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
message String
Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
- is_override_allowed Boolean
  Indicates whether a person at the thermostat can change the thermostat's settings after the thermostat schedule starts.
- max_override_period_minutes Number
  Number of minutes for which a person at the thermostat can change the thermostat's settings after the activation of the scheduled climate preset. See also Specifying Manual Override Permissions.
- name String
  User-friendly name to identify the thermostat schedule.
- starts_at Datetime
  Date and time at which the thermostat schedule starts, in ISO 8601 format.
- thermostat_schedule_id UUID
  ID of the thermostat schedule.
- workspace_id UUID
  ID of the workspace that contains the thermostat schedule.

active_thermostat_schedule_id UUID

ID of the active thermostat schedule.

akiles_metadata Object

Metadata for an Akiles device.

Child Properties

_member_group_id String
Group ID to which to add users for an Akiles device.
gadget_id String
Gadget ID for an Akiles device.
gadget_name String
Gadget name for an Akiles device.
product_name String
Product name for an Akiles device.

assa_abloy_credential_service_metadata Object

ASSA ABLOY Credential Service metadata for the phone.

Child Properties

endpoints List of Objects
Endpoints associated with the phone.
endpoint_id String
ID of the associated endpoint.
is_active Boolean
Indicated whether the endpoint is active.
- has_active_endpoint Boolean
  Indicates whether the credential service has active endpoints associated with the phone.

assa_abloy_vostio_metadata Object

Metadata for an ASSA ABLOY Vostio system.

Child Properties

encoder_name String
Encoder name for an ASSA ABLOY Vostio system.

august_metadata Object

Metadata for an August device.

Child Properties

has_keypad Boolean
Indicates whether an August device has a keypad.
house_id String
House ID for an August device.
house_name String
House name for an August device.
keypad_battery_level String
Keypad battery level for an August device.
lock_id String
Lock ID for an August device.
lock_name String
Lock name for an August device.
model String
Model for an August device.

available_climate_preset_modes List of Enums

Climate preset modes that the thermostat supports, such as "home", "away", "wake", "sleep", "occupied", and "unoccupied".

available_climate_presets List of Objects

Available climate presets for the thermostat.

Child Object Properties

can_delete Boolean

Indicates whether the climate preset key can be deleted.

can_edit Boolean

Indicates whether the climate preset key can be edited.

can_use_with_thermostat_daily_programs Boolean

Indicates whether the climate preset key can be programmed in a thermostat daily program.

climate_preset_key String

Unique key to identify the climate preset.

climate_preset_mode Enum

The climate preset mode for the thermostat, based on the available climate preset modes reported by the device.

cooling_set_point_celsius Number

Temperature to which the thermostat should cool (in °C). See also Set Points.

cooling_set_point_fahrenheit Number

Temperature to which the thermostat should cool (in °F). See also Set Points.

display_name String

Display name for the climate preset.

ecobee_metadata Object

Metadata specific to the Ecobee climate, if applicable.

ecobee_metadata.climate_ref String

Reference to the Ecobee climate, if applicable.

ecobee_metadata.is_optimized Boolean

Indicates if the climate preset is optimized by Ecobee.

ecobee_metadata.owner Enum

Indicates whether the climate preset is owned by the user or the system.

fan_mode_setting Enum

Desired fan mode setting, such as on, auto, or circulate.

heating_set_point_celsius Number

Temperature to which the thermostat should heat (in °C). See also Set Points.

heating_set_point_fahrenheit Number

Temperature to which the thermostat should heat (in °F). See also Set Points.

hvac_mode_setting Enum

Desired HVAC mode setting, such as heat, cool, heat_cool, or off.

manual_override_allowed Boolean

Indicates whether a person at the thermostat can change the thermostat's settings. See Specifying Manual Override Permissions.

Deprecated. Use 'thermostat_schedule.is_override_allowed'

name String

User-friendly name to identify the climate preset.

available_fan_mode_settings List of Enums

Fan mode settings that the thermostat supports.

available_hvac_mode_settings List of Enums

HVAC mode settings that the thermostat supports.

avigilon_alta_metadata Object

Metadata for an Avigilon Alta system.

Child Properties

entry_name String
Entry name for an Avigilon Alta system.
entry_relays_total_count Number
Total count of entry relays for an Avigilon Alta system.
org_name String
Organization name for an Avigilon Alta system.
site_id Number
Site ID for an Avigilon Alta system.
site_name String
Site name for an Avigilon Alta system.
zone_id Number
Zone ID for an Avigilon Alta system.
zone_name String
Zone name for an Avigilon Alta system.

brivo_metadata Object

Metadata for a Brivo device.

Child Properties

activation_enabled Boolean
Indicates whether the Brivo access point has activation (remote unlock) enabled.
device_name String
Device name for a Brivo device.

controlbyweb_metadata Object

Metadata for a ControlByWeb device.

Child Properties

device_id String
Device ID for a ControlByWeb device.
device_name String
Device name for a ControlByWeb device.
relay_name String
Relay name for a ControlByWeb device.

current_climate_setting Object

Current climate setting.

Child Properties

can_delete Boolean
Indicates whether the climate preset key can be deleted.
can_edit Boolean
Indicates whether the climate preset key can be edited.
can_use_with_thermostat_daily_programs Boolean
Indicates whether the climate preset key can be programmed in a thermostat daily program.
climate_preset_key String
Unique key to identify the climate preset.
climate_preset_mode Enum
The climate preset mode for the thermostat, based on the available climate preset modes reported by the device.
cooling_set_point_celsius Number
Temperature to which the thermostat should cool (in °C). See also Set Points.
cooling_set_point_fahrenheit Number
Temperature to which the thermostat should cool (in °F). See also Set Points.
display_name String
Display name for the climate preset.
ecobee_metadata Object
Metadata specific to the Ecobee climate, if applicable.
ecobee_metadata.climate_ref String
Reference to the Ecobee climate, if applicable.
ecobee_metadata.is_optimized Boolean
Indicates if the climate preset is optimized by Ecobee.
ecobee_metadata.owner Enum
Indicates whether the climate preset is owned by the user or the system.
fan_mode_setting Enum
Desired fan mode setting, such as on, auto, or circulate.
heating_set_point_celsius Number
Temperature to which the thermostat should heat (in °C). See also Set Points.
heating_set_point_fahrenheit Number
Temperature to which the thermostat should heat (in °F). See also Set Points.
hvac_mode_setting Enum
Desired HVAC mode setting, such as heat, cool, heat_cool, or off.
manual_override_allowed Boolean
Indicates whether a person at the thermostat can change the thermostat's settings. See Specifying Manual Override Permissions.

Deprecated. Use 'thermostat_schedule.is_override_allowed'

name String
User-friendly name to identify the climate preset.

default_climate_setting Object

Deprecated. use fallback_climate_preset_key to specify a fallback climate preset instead.

Child Properties

can_delete Boolean
Indicates whether the climate preset key can be deleted.
can_edit Boolean
Indicates whether the climate preset key can be edited.
can_use_with_thermostat_daily_programs Boolean
Indicates whether the climate preset key can be programmed in a thermostat daily program.
climate_preset_key String
Unique key to identify the climate preset.
climate_preset_mode Enum
The climate preset mode for the thermostat, based on the available climate preset modes reported by the device.
cooling_set_point_celsius Number
Temperature to which the thermostat should cool (in °C). See also Set Points.
cooling_set_point_fahrenheit Number
Temperature to which the thermostat should cool (in °F). See also Set Points.
display_name String
Display name for the climate preset.
ecobee_metadata Object
Metadata specific to the Ecobee climate, if applicable.
ecobee_metadata.climate_ref String
Reference to the Ecobee climate, if applicable.
ecobee_metadata.is_optimized Boolean
Indicates if the climate preset is optimized by Ecobee.
ecobee_metadata.owner Enum
Indicates whether the climate preset is owned by the user or the system.
fan_mode_setting Enum
Desired fan mode setting, such as on, auto, or circulate.
heating_set_point_celsius Number
Temperature to which the thermostat should heat (in °C). See also Set Points.
heating_set_point_fahrenheit Number
Temperature to which the thermostat should heat (in °F). See also Set Points.
hvac_mode_setting Enum
Desired HVAC mode setting, such as heat, cool, heat_cool, or off.
manual_override_allowed Boolean
Indicates whether a person at the thermostat can change the thermostat's settings. See Specifying Manual Override Permissions.

Deprecated. Use 'thermostat_schedule.is_override_allowed'

name String
User-friendly name to identify the climate preset.

dormakaba_oracode_metadata Object

Metadata for a dormakaba Oracode device.

Child Properties

device_id Object
Device ID for a dormakaba Oracode device.
door_id Number
Door ID for a dormakaba Oracode device.
door_is_wireless Boolean
Indicates whether a door is wireless for a dormakaba Oracode device.
door_name String
Door name for a dormakaba Oracode device.
iana_timezone String
IANA time zone for a dormakaba Oracode device.
predefined_time_slots List of Objects
Predefined time slots for a dormakaba Oracode device.
check_in_time String
Check in time for a time slot for a dormakaba Oracode device.
check_out_time String
Checkout time for a time slot for a dormakaba Oracode device.
dormakaba_oracode_user_level_id UUID
ID of a user level for a dormakaba Oracode device.
ext_dormakaba_oracode_user_level_prefix Number
Prefix for a user level for a dormakaba Oracode device.
is_24_hour Boolean
Indicates whether a time slot for a dormakaba Oracode device is a 24-hour time slot.
is_biweekly_mode Boolean
Indicates whether a time slot for a dormakaba Oracode device is in biweekly mode.
is_master Boolean
Indicates whether a time slot for a dormakaba Oracode device is a master time slot.
is_one_shot Boolean
Indicates whether a time slot for a dormakaba Oracode device is a one-shot time slot.
name String
Name of a time slot for a dormakaba Oracode device.
prefix Number
Prefix for a time slot for a dormakaba Oracode device.
- site_id Number
  Site ID for a dormakaba Oracode device.
Deprecated. Previously marked as "@DEPRECATED."
- site_name String
  Site name for a dormakaba Oracode device.

ecobee_metadata Object

Metadata for an ecobee device.

Child Properties

device_name String
Device name for an ecobee device.
ecobee_device_id String
Device ID for an ecobee device.

fallback_climate_preset_key String

Key of the fallback climate preset for the thermostat.

fan_mode_setting Enum

Deprecated. Use current_climate_setting.fan_mode_setting instead.

Enum values

auto
on
circulate

four_suites_metadata Object

Metadata for a 4SUITES device.

Child Properties

device_id Number
Device ID for a 4SUITES device.
device_name String
Device name for a 4SUITES device.
reclose_delay_in_seconds Number
Reclose delay, in seconds, for a 4SUITES device.

genie_metadata Object

Metadata for a Genie device.

Child Properties

device_name String
Lock name for a Genie device.
door_name String
Door name for a Genie device.

honeywell_resideo_metadata Object

Metadata for a Honeywell Resideo device.

Child Properties

device_name String
Device name for a Honeywell Resideo device.
honeywell_resideo_device_id String
Device ID for a Honeywell Resideo device.

hubitat_metadata Object

Metadata for a Hubitat device.

Child Properties

device_id String
Device ID for a Hubitat device.
device_label String
Device label for a Hubitat device.
device_name String
Device name for a Hubitat device.

igloo_metadata Object

Metadata for an igloo device.

Child Properties

bridge_id String
Bridge ID for an igloo device.
device_id String
Device ID for an igloo device.
model String
Model for an igloo device.

igloohome_metadata Object

Metadata for an igloohome device.

Child Properties

bridge_id String
Bridge ID for an igloohome device.
bridge_name String
Bridge name for an igloohome device.
device_id String
Device ID for an igloohome device.
device_name String
Device name for an igloohome device.
is_accessory_keypad_linked_to_bridge Boolean
Indicates whether a keypad is linked to a bridge for an igloohome device.
keypad_id String
Keypad ID for an igloohome device.

is_cooling Boolean

Indicates whether the connected HVAC system is currently cooling, as reported by the thermostat.

is_fan_running Boolean

Indicates whether the fan in the connected HVAC system is currently running, as reported by the thermostat.

is_heating Boolean

Indicates whether the connected HVAC system is currently heating, as reported by the thermostat.

is_temporary_manual_override_active Boolean

Indicates whether the current thermostat settings differ from the most recent active program or schedule that Seam activated. For this condition to occur, current_climate_setting.manual_override_allowed must also be true.

keynest_metadata Object

Metadata for a KeyNest device.

Child Properties

address String
Address for a KeyNest device.
current_or_last_store_id Number
Current or last store ID for a KeyNest device.
current_status String
Current status for a KeyNest device.
current_user_company String
Current user company for a KeyNest device.
current_user_email String
Current user email for a KeyNest device.
current_user_name String
Current user name for a KeyNest device.
current_user_phone_number String
Current user phone number for a KeyNest device.
default_office_id Number
Default office ID for a KeyNest device.
device_name String
Device name for a KeyNest device.
fob_id Number
Fob ID for a KeyNest device.
handover_method String
Handover method for a KeyNest device.
has_photo Boolean
Whether the KeyNest device has a photo.
is_quadient_locker Boolean
Whether the key is in a locker that does not support the access codes API.
key_id String
Key ID for a KeyNest device.
key_notes String
Key notes for a KeyNest device.
keynest_app_user String
KeyNest app user for a KeyNest device.
last_movement String
Last movement timestamp for a KeyNest device.
property_id String
Property ID for a KeyNest device.
property_postcode String
Property postcode for a KeyNest device.
status_type String
Status type for a KeyNest device.
subscription_plan String
Subscription plan for a KeyNest device.

korelock_metadata Object

Metadata for a Korelock device.

Child Properties

device_id String
Device ID for a Korelock device.
device_name String
Device name for a Korelock device.
firmware_version String
Firmware version for a Korelock device.
model_code String
Model code for a Korelock device.
serial_number String
Serial number for a Korelock device.
wifi_signal_strength Number
WiFi signal strength (0-1) for a Korelock device.

kwikset_metadata Object

Metadata for a Kwikset device.

Child Properties

device_id String
Device ID for a Kwikset device.
device_name String
Device name for a Kwikset device.
model_number String
Model number for a Kwikset device.

lockly_metadata Object

Metadata for a Lockly device.

Child Properties

device_id String
Device ID for a Lockly device.
device_name String
Device name for a Lockly device.
model String
Model for a Lockly device.

max_cooling_set_point_celsius Number

Maximum cooling set point in °C.

max_cooling_set_point_fahrenheit Number

Maximum cooling set point in °F.

max_heating_set_point_celsius Number

Maximum heating set point in °C.

max_heating_set_point_fahrenheit Number

Maximum heating set point in °F.

max_thermostat_daily_program_periods_per_day Number

Maximum number of periods that the thermostat can support per day. For example, if the thermostat supports 4 periods per day, this value is 4.

max_unique_climate_presets_per_thermostat_weekly_program Number

Maximum number of climate presets that the thermostat can support for weekly programming.

min_cooling_set_point_celsius Number

Minimum cooling set point in °C.

min_cooling_set_point_fahrenheit Number

Minimum cooling set point in °F.

min_heating_cooling_delta_celsius Number

Minimum temperature difference in °C between the cooling and heating set points when in heat-cool (auto) mode.

min_heating_cooling_delta_fahrenheit Number

Minimum temperature difference in °F between the cooling and heating set points when in heat-cool (auto) mode.

min_heating_set_point_celsius Number

Minimum heating set point in °C.

min_heating_set_point_fahrenheit Number

Minimum heating set point in °F.

minut_metadata Object

Metadata for a Minut device.

Child Properties

device_id String
Device ID for a Minut device.
device_name String
Device name for a Minut device.
latest_sensor_values Object
Latest sensor values for a Minut device.
latest_sensor_values.accelerometer_z Object
Latest accelerometer Z-axis reading for a Minut device.
latest_sensor_values.accelerometer_z.time String
Time of latest accelerometer Z-axis reading for a Minut device.
latest_sensor_values.accelerometer_z.value Number
Value of latest accelerometer Z-axis reading for a Minut device.
latest_sensor_values.humidity Object
Latest humidity reading for a Minut device.
latest_sensor_values.humidity.time String
Time of latest humidity reading for a Minut device.
latest_sensor_values.humidity.value Number
Value of latest humidity reading for a Minut device.
latest_sensor_values.pressure Object
Latest pressure reading for a Minut device.
latest_sensor_values.pressure.time String
Time of latest pressure reading for a Minut device.
latest_sensor_values.pressure.value Number
Value of latest pressure reading for a Minut device.
latest_sensor_values.sound Object
Latest sound reading for a Minut device.
latest_sensor_values.sound.time String
Time of latest sound reading for a Minut device.
latest_sensor_values.sound.value Number
Value of latest sound reading for a Minut device.
latest_sensor_values.temperature Object
Latest temperature reading for a Minut device.
latest_sensor_values.temperature.time String
Time of latest temperature reading for a Minut device.
latest_sensor_values.temperature.value Number
Value of latest temperature reading for a Minut device.

model Object

Device model-related properties.

Child Properties

accessory_keypad_supported Boolean

Deprecated. use device.properties.model.can_connect_accessory_keypad

can_connect_accessory_keypad Boolean
Indicates whether the device can connect a accessory keypad.
display_name String
Display name of the device model.
has_built_in_keypad Boolean
Indicates whether the device has a built in accessory keypad.
manufacturer_display_name String
Display name that corresponds to the manufacturer-specific terminology for the device.
offline_access_codes_supported Boolean

Deprecated. use device.can_program_offline_access_codes.

online_access_codes_supported Boolean

Deprecated. use device.can_program_online_access_codes.

name String

Name of the device.

Deprecated. use device.display_name instead

nest_metadata Object

Metadata for a Google Nest device.

Child Properties

device_custom_name String
Custom device name for a Google Nest device. The device owner sets this value.
device_name String
Device name for a Google Nest device. Google sets this value.
display_name String
Display name for a Google Nest device.
nest_device_id String
Device ID for a Google Nest device.

noiseaware_metadata Object

Metadata for a NoiseAware device.

Child Properties

device_id String
Device ID for a NoiseAware device.
device_model Enum
Device model for a NoiseAware device.
device_name String
Device name for a NoiseAware device.
noise_level_decibel Number
Noise level, in decibels, for a NoiseAware device.
noise_level_nrs Number
Noise level, expressed as a Noise Risk Score (NRS), for a NoiseAware device.

nuki_metadata Object

Metadata for a Nuki device.

Child Properties

device_id String
Device ID for a Nuki device.
device_name String
Device name for a Nuki device.
keypad_2_paired Boolean
Indicates whether keypad 2 is paired for a Nuki device.
keypad_battery_critical Boolean
Indicates whether the keypad battery is in a critical state for a Nuki device.
keypad_paired Boolean
Indicates whether the keypad is paired for a Nuki device.

online Boolean

Indicates whether the device is online.

relative_humidity Number

Reported relative humidity, as a value between 0 and 1, inclusive.

salto_ks_metadata Object

Metadata for a Salto KS device.

Child Properties

battery_level String
Battery level for a Salto KS device.
customer_reference String
Customer reference for a Salto KS device.
has_custom_pin_subscription Boolean
Indicates whether the site has a Salto KS subscription that supports custom PINs.
lock_id String
Lock ID for a Salto KS device.
lock_type String
Lock type for a Salto KS device.
locked_state String
Locked state for a Salto KS device.
model String
Model for a Salto KS device.

salto_metadata Object

Metada for a Salto device.

Deprecated. Use salto_ks_metadata instead.

Child Properties

battery_level String
Battery level for a Salto device.
customer_reference String
Customer reference for a Salto device.
lock_id String
Lock ID for a Salto device.
lock_type String
Lock type for a Salto device.
locked_state String
Locked state for a Salto device.
model String
Model for a Salto device.

salto_space_credential_service_metadata Object

Salto Space credential service metadata for the phone.

Child Properties

has_active_phone Boolean
Indicates whether the credential service has an active associated phone.

schlage_metadata Object

Metadata for a Schlage device.

Child Properties

device_id String
Device ID for a Schlage device.
device_name String
Device name for a Schlage device.
model String
Model for a Schlage device.

seam_bridge_metadata Object

Metadata for Seam Bridge.

Child Properties

device_num Number
Device number for Seam Bridge.
name String
Name for Seam Bridge.
unlock_method Enum
Unlock method for Seam Bridge.

sensi_metadata Object

Metadata for a Sensi device.

Child Properties

device_id String
Device ID for a Sensi device.
device_name String
Device name for a Sensi device.
product_type String
Product type for a Sensi device.

smartthings_metadata Object

Metadata for a SmartThings device.

Child Properties

device_id String
Device ID for a SmartThings device.
device_name String
Device name for a SmartThings device.
location_id String
Location ID for a SmartThings device.
model String
Model for a SmartThings device.

tado_metadata Object

Metadata for a tado° device.

Child Properties

device_type String
Device type for a tado° device.
serial_no String
Serial number for a tado° device.

tedee_metadata Object

Metadata for a Tedee device.

Child Properties

bridge_id Number
Bridge ID for a Tedee device.
bridge_name String
Bridge name for a Tedee device.
device_id Number
Device ID for a Tedee device.
device_model String
Device model for a Tedee device.
device_name String
Device name for a Tedee device.
keypad_id Number
Keypad ID for a Tedee device.
serial_number String
Serial number for a Tedee device.

temperature_celsius Number

Reported temperature in °C.

temperature_fahrenheit Number

Reported temperature in °F.

temperature_threshold Object

Current temperature threshold set for the thermostat.

Child Properties

lower_limit_celsius Number
Lower limit in °C within the current temperature threshold set for the thermostat.
lower_limit_fahrenheit Number
Lower limit in °F within the current temperature threshold set for the thermostat.
upper_limit_celsius Number
Upper limit in °C within the current temperature threshold set for the thermostat.
upper_limit_fahrenheit Number
Upper limit in °F within the current temperature threshold set for the thermostat.

thermostat_daily_program_period_precision_minutes Number

Precision of the thermostat's period in minutes. For example, if the thermostat supports 15-minute periods, this value is 15. All values are relative to the top of the hour, so for 15 minutes, the periods would be 0, 15, 30, and 45 minutes past the hour.

thermostat_daily_programs List of Objects

Configured daily programs for the thermostat.

Child Object Properties

created_at Datetime

Date and time at which the thermostat daily program was created.

device_id UUID

ID of the thermostat device on which the thermostat daily program is configured.

name String

User-friendly name to identify the thermostat daily program.

periods List of Objects

Array of thermostat daily program periods.

climate_preset_key String
Key of the climate preset to activate at the starts_at_time.
starts_at_time String
Time at which the thermostat daily program period starts, in ISO 8601 format.

thermostat_daily_program_id UUID

ID of the thermostat daily program.

workspace_id UUID

ID of the workspace that contains the thermostat daily program.

thermostat_weekly_program Object

Current weekly program for the thermostat.

Child Properties

created_at Datetime
Date and time at which the thermostat weekly program was created.
friday_program_id UUID
ID of the thermostat daily program to run on Fridays.
monday_program_id UUID
ID of the thermostat daily program to run on Mondays.
saturday_program_id UUID
ID of the thermostat daily program to run on Saturdays.
sunday_program_id UUID
ID of the thermostat daily program to run on Sundays.
thursday_program_id UUID
ID of the thermostat daily program to run on Thursdays.
tuesday_program_id UUID
ID of the thermostat daily program to run on Tuesdays.
wednesday_program_id UUID
ID of the thermostat daily program to run on Wednesdays.

ttlock_metadata Object

Metadata for a TTLock device.

Child Properties

feature_value String
Feature value for a TTLock device.
features Object
Features for a TTLock device.
features.incomplete_keyboard_passcode Boolean
Indicates whether a TTLock device supports an incomplete keyboard passcode.
features.lock_command Boolean
Indicates whether a TTLock device supports the lock command.
features.passcode Boolean
Indicates whether a TTLock device supports a passcode.
features.passcode_management Boolean
Indicates whether a TTLock device supports passcode management.
features.unlock_via_gateway Boolean
Indicates whether a TTLock device supports unlock via gateway.
features.wifi Boolean
Indicates whether a TTLock device supports Wi-Fi.
has_gateway Boolean
Indicates whether a TTLock device has a gateway.
lock_alias String
Lock alias for a TTLock device.
lock_id Number
Lock ID for a TTLock device.
wireless_keypads List of Objects
Wireless keypads for a TTLock device.
wireless_keypad_id Number
ID for a wireless keypad for a TTLock device.
wireless_keypad_name String
Name for a wireless keypad for a TTLock device.

two_n_metadata Object

Metadata for a 2N device.

Child Properties

device_id Number
Device ID for a 2N device.
device_name String
Device name for a 2N device.

ultraloq_metadata Object

Metadata for an Ultraloq device.

Child Properties

device_id String
Device ID for an Ultraloq device.
device_name String
Device name for an Ultraloq device.
device_type String
Device type for an Ultraloq device.
time_zone String
IANA timezone for the Ultraloq device.

visionline_metadata Object

Metadata for an ASSA ABLOY Visionline system.

Child Properties

encoder_id String
Encoder ID for an ASSA ABLOY Visionline system.

wyze_metadata Object

Metadata for a Wyze device.

Child Properties

device_id String
Device ID for a Wyze device.
device_info_model String
Device information model for a Wyze device.
device_name String
Device name for a Wyze device.
keypad_uuid String
Keypad UUID for a Wyze device.
locker_status_hardlock Number
Locker status (hardlock) for a Wyze device.
product_model String
Product model for a Wyze device.
product_name String
Product name for a Wyze device.
product_type String
Product type for a Wyze device.

Errors

auxiliary_heat_running

Indicates that the auxiliary heat is running.

ttlock_lock_not_paired_to_gateway

Indicates that the lock is not paired with a gateway.

subscription_required

Indicates that a subscription is required to connect.

missing_device_credentials

Indicates that device credentials are missing.

lockly_missing_wifi_bridge

Indicates that the Lockly lock is not connected to a Wi-Fi bridge.

hub_disconnected

Indicates that the hub is disconnected.

device_removed

Indicates that the device has been removed.

device_offline

Indicates that the device is offline.

device_disconnected

Indicates that the device is disconnected.

account_disconnected

Indicates that the account is disconnected.

bridge_disconnected

Warnings

device_communication_degraded

Indicates that the device appears to be unresponsive.

device_has_flaky_connection

Indicates that the device has a flaky connection.

lockly_time_zone_not_configured

Indicates that Seam detected that the Lockly device does not have a time zone configured. Time-bound codes may not work as expected.

salto_ks_subscription_limit_almost_reached

Indicates that the Salto KS site has exceeded 80% of the maximum number of allowed users. Increase your subscription limit or delete some users from your site.

scheduled_maintenance_window

Indicates that a scheduled maintenance window has been detected.

temperature_threshold_exceeded

Indicates that the temperature threshold has been exceeded.

third_party_integration_detected

Indicates that a third-party integration has been detected.

ttlock_weak_gateway_signal

Indicates that the gateway signal is weak.

ultraloq_time_zone_unknown

Indicates that Seam does not know the time zone of the Ultraloq device. Set a time zone to enable time-bound access codes.

wyze_device_missing_gateway

Indicates that the Wyze Lock is not connected to a gateway.

Events

thermostat.climate_preset_activated

A thermostat climate preset was activated.

Properties

climate_preset_key String

Key of the climate preset that was activated.

connected_account_custom_metadata Record

Custom metadata of the connected account, present when connected_account_id is provided.

connected_account_id UUID

ID of the connected account associated with the event.

created_at Datetime

Date and time at which the event was created.

device_custom_metadata Record

Custom metadata of the device, present when device_id is provided.

device_id UUID

ID of the affected device.

event_id UUID

ID of the event.

event_type Enum

Value: thermostat.climate_preset_activated

is_fallback_climate_preset Boolean

Indicates whether the climate preset that was activated is the fallback climate preset for the thermostat.

occurred_at Datetime

Date and time at which the event occurred.

thermostat_schedule_id UUID

ID of the thermostat schedule that prompted the affected climate preset to be activated.

workspace_id UUID

ID of the workspace associated with the event.

thermostat.manually_adjusted

A thermostat was adjusted manually.

Properties

connected_account_custom_metadata Record

Custom metadata of the connected account, present when connected_account_id is provided.

connected_account_id UUID

ID of the connected account associated with the event.

cooling_set_point_celsius Number

Temperature to which the thermostat should cool (in °C). See also Set Points.

cooling_set_point_fahrenheit Number

Temperature to which the thermostat should cool (in °F). See also Set Points.

created_at Datetime

Date and time at which the event was created.

device_custom_metadata Record

Custom metadata of the device, present when device_id is provided.

device_id UUID

ID of the affected device.

event_id UUID

ID of the event.

event_type Enum

Value: thermostat.manually_adjusted

fan_mode_setting Enum

Desired fan mode setting, such as on, auto, or circulate.

heating_set_point_celsius Number

Temperature to which the thermostat should heat (in °C). See also Set Points.

heating_set_point_fahrenheit Number

Temperature to which the thermostat should heat (in °F). See also Set Points.

hvac_mode_setting Enum

Desired HVAC mode setting, such as heat, cool, heat_cool, or off.

method Enum

Method used to adjust the affected thermostat manually. seam indicates that the Seam API, Seam CLI, or Seam Console was used to adjust the thermostat.

occurred_at Datetime

Date and time at which the event occurred.

workspace_id UUID

ID of the workspace associated with the event.

thermostat.temperature_threshold_exceeded

A thermostat's temperature reading exceeded the set threshold.

Properties

connected_account_custom_metadata Record

Custom metadata of the connected account, present when connected_account_id is provided.

connected_account_id UUID

ID of the connected account associated with the event.

created_at Datetime

Date and time at which the event was created.

device_custom_metadata Record

Custom metadata of the device, present when device_id is provided.

device_id UUID

ID of the affected device.

event_id UUID

ID of the event.

event_type Enum

Value: thermostat.temperature_threshold_exceeded

lower_limit_celsius Number

Lower temperature limit, in °C, defined by the set threshold.

lower_limit_fahrenheit Number

Lower temperature limit, in °F, defined by the set threshold.

occurred_at Datetime

Date and time at which the event occurred.

temperature_celsius Number

Temperature, in °C, reported by the affected thermostat.

temperature_fahrenheit Number

Temperature, in °F, reported by the affected thermostat.

upper_limit_celsius Number

Upper temperature limit, in °C, defined by the set threshold.

upper_limit_fahrenheit Number

Upper temperature limit, in °F, defined by the set threshold.

workspace_id UUID

ID of the workspace associated with the event.

thermostat.temperature_threshold_no_longer_exceeded

A thermostat's temperature reading no longer exceeds the set threshold.

Properties

connected_account_custom_metadata Record

Custom metadata of the connected account, present when connected_account_id is provided.

connected_account_id UUID

ID of the connected account associated with the event.

created_at Datetime

Date and time at which the event was created.

device_custom_metadata Record

Custom metadata of the device, present when device_id is provided.

device_id UUID

ID of the affected device.

event_id UUID

ID of the event.

event_type Enum

Value: thermostat.temperature_threshold_no_longer_exceeded

lower_limit_celsius Number

Lower temperature limit, in °C, defined by the set threshold.

lower_limit_fahrenheit Number

Lower temperature limit, in °F, defined by the set threshold.

occurred_at Datetime

Date and time at which the event occurred.

temperature_celsius Number

Temperature, in °C, reported by the affected thermostat.

temperature_fahrenheit Number

Temperature, in °F, reported by the affected thermostat.

upper_limit_celsius Number

Upper temperature limit, in °C, defined by the set threshold.

upper_limit_fahrenheit Number

Upper temperature limit, in °F, defined by the set threshold.

workspace_id UUID

ID of the workspace associated with the event.

thermostat.temperature_reached_set_point

A thermostat's temperature reading is within 1 °C of the configured cooling or heating set point.

Properties

connected_account_custom_metadata Record

Custom metadata of the connected account, present when connected_account_id is provided.

connected_account_id UUID

ID of the connected account associated with the event.

created_at Datetime

Date and time at which the event was created.

desired_temperature_celsius Number

Desired temperature, in °C, defined by the affected thermostat's cooling or heating set point.

desired_temperature_fahrenheit Number

Desired temperature, in °F, defined by the affected thermostat's cooling or heating set point.

device_custom_metadata Record

Custom metadata of the device, present when device_id is provided.

device_id UUID

ID of the affected device.

event_id UUID

ID of the event.

event_type Enum

Value: thermostat.temperature_reached_set_point

occurred_at Datetime

Date and time at which the event occurred.

temperature_celsius Number

Temperature, in °C, reported by the affected thermostat.

temperature_fahrenheit Number

Temperature, in °F, reported by the affected thermostat.

workspace_id UUID

ID of the workspace associated with the event.

thermostat.temperature_changed

A thermostat's reported temperature changed by at least 1 °C.

Properties

connected_account_custom_metadata Record

Custom metadata of the connected account, present when connected_account_id is provided.

connected_account_id UUID

ID of the connected account associated with the event.

created_at Datetime

Date and time at which the event was created.

device_custom_metadata Record

Custom metadata of the device, present when device_id is provided.

device_id UUID

ID of the affected device.

event_id UUID

ID of the event.

event_type Enum

Value: thermostat.temperature_changed

occurred_at Datetime

Date and time at which the event occurred.

temperature_celsius Number

Temperature, in °C, reported by the affected thermostat.

temperature_fahrenheit Number

Temperature, in °F, reported by the affected thermostat.

workspace_id UUID

ID of the workspace associated with the event.

Endpoints

/thermostats/activate_climate_preset

Activates a specified climate preset for a specified thermostat.

/thermostats/cool

Sets a specified thermostat to cool mode.

/thermostats/create_climate_preset

Creates a climate preset for a specified thermostat.

/thermostats/delete_climate_preset

Deletes a specified climate preset for a specified thermostat.

/thermostats/heat

Sets a specified thermostat to heat mode.

/thermostats/heat_cool

Sets a specified thermostat to heat-cool ("auto") mode.

/thermostats/list

Returns a list of all thermostats.

/thermostats/off

Sets a specified thermostat to "off" mode.

/thermostats/set_fallback_climate_preset

Sets a specified climate preset as the "fallback" preset for a specified thermostat.

/thermostats/set_fan_mode

Sets the fan mode setting for a specified thermostat.

/thermostats/set_hvac_mode

Sets the HVAC mode for a specified thermostat.

/thermostats/set_temperature_threshold

Sets a temperature threshold for a specified thermostat. Seam emits a thermostat.temperature_threshold_exceeded event and adds a warning on a thermostat if it reports a temperature outside the threshold range.

/thermostats/update_climate_preset

Updates a specified climate preset for a specified thermostat.

/thermostats/update_weekly_program

Updates the thermostat weekly program for a thermostat device. To configure a weekly program, specify the ID of the daily program that you want to use for each day of the week. When you update a weekly program, the set of programs that you specify overwrites any previous weekly program for the thermostat.

PreviousUpdate a Space NextActivate a Climate Preset

Last updated 1 day ago

Was this helpful?

hashtagThe device Object for Thermostats

hashtagProperties

hashtagdevice.properties

hashtagErrors

hashtagWarnings

hashtagEvents

hashtagEndpoints

The device Object for Thermostats

Properties

device.properties

Errors

Warnings

Events

Endpoints