@seamapi/types 1.406.0 → 1.406.1

package/dist/connect.cjs

@@ -53,7 +53,9 @@ var capabilities = zod.z.enum([
   "thermostat",
   "battery",
   "phone"
-]);
+]).describe(`
+        Collection of capabilities that the device supports when connected to Seam. **Important:** Superseded by [capability flags](https://docs.seam.co/latest/capability-guides/device-and-system-capabilities#capability-flags).
+        `);
 var access_code_code_constraint = zod.z.object({
   constraint_type: zod.z.enum([
     "no_zeros",
@@ -76,34 +78,69 @@ var access_code_code_constraint = zod.z.object({
     // TTLock
     "cannot_contain_0789"
     // TTLock (for some cylinder devices only)
-  ])
-});
+  ]).describe(`Code constraint type for access codes.`)
+}).describe(`Code constraint for access codes.`);
 var access_code_name_constraint = zod.z.object({
   constraint_type: zod.z.enum(["name_length", "name_must_be_unique"]),
   // Nuki, Kwikset
-  min_length: zod.z.number().optional(),
-  max_length: zod.z.number().optional()
-});
-var access_code_constraint = zod.z.union([
-  access_code_code_constraint,
-  access_code_name_constraint
-]);
+  min_length: zod.z.number().optional().describe(`Minimum name length constraint for access codes.`),
+  max_length: zod.z.number().optional().describe(`Maximum name length constraint for access codes.`)
+}).describe(`Name constraint for access codes.`);
+var access_code_constraint = zod.z.union([access_code_code_constraint, access_code_name_constraint]).describe(`Access code constraint.`);
 var access_code_capability_properties = zod.z.object({
-  _experimental_supported_code_from_access_codes_lengths: zod.z.array(zod.z.number()).optional(),
-  code_constraints: zod.z.array(access_code_constraint).optional().describe(
-    "Constraints on access codes for the device. Seam represents each constraint as an object with a `constraint_type` property. Depending on the constraint type, there may also be additional properties. Note that some constraints are manufacturer- or device-specific."
-  ),
-  supported_code_lengths: zod.z.array(zod.z.number()).optional(),
-  max_active_codes_supported: zod.z.number().optional(),
-  supports_backup_access_code_pool: zod.z.boolean().optional(),
-  has_native_entry_events: zod.z.boolean().optional()
+  _experimental_supported_code_from_access_codes_lengths: zod.z.array(zod.z.number()).optional().describe(`
+          ---
+          undocumented: Marked as experimental.
+          ---
+          `),
+  code_constraints: zod.z.array(access_code_constraint).optional().describe(`
+          ---
+          property_group_key: access_codes
+          ---
+          Constraints on access codes for the device. Seam represents each constraint as an object with a \`constraint_type\` property. Depending on the constraint type, there may also be additional properties. Note that some constraints are manufacturer- or device-specific.`),
+  supported_code_lengths: zod.z.array(zod.z.number()).optional().describe(`
+          ---
+          property_group_key: access_codes
+          ---
+          Supported code lengths for access codes.`),
+  max_active_codes_supported: zod.z.number().optional().describe(`
+          ---
+          property_group_key: access_codes
+          ---
+          Maximum number of active access codes that the device supports.`),
+  supports_backup_access_code_pool: zod.z.boolean().optional().describe(`
+          ---
+          property_group_key: access_codes
+          ---
+          Indicates whether the device supports a [backup access code pool](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes/backup-access-codes).`),
+  has_native_entry_events: zod.z.boolean().optional().describe(`
+          ---
+          property_group_key: access_codes
+          ---
+          Indicates whether the device supports native entry events.`)
 });
 var lock_capability_properties = zod.z.object({
-  locked: zod.z.boolean().optional(),
+  locked: zod.z.boolean().optional().describe(`
+          ---
+          property_group_key: locks
+          ---
+          Indicates whether the lock is locked.
+          `),
   keypad_battery: zod.z.object({
-    level: zod.z.number()
-  }).optional(),
-  door_open: zod.z.boolean().optional()
+    level: zod.z.number().describe(`Keypad battery charge level.
+          `)
+  }).optional().describe(`
+          ---
+          property_group_key: access_codes
+          ---
+          Keypad battery status.
+          `),
+  door_open: zod.z.boolean().optional().describe(`
+          ---
+          property_group_key: locks
+          ---
+          Indicates whether the door is open.
+          `)
 });
 var hvac_mode_setting = zod.z.enum(["off", "heat", "cool", "heat_cool"]);
 var fan_mode_setting = zod.z.enum(["auto", "on", "circulate"]);
@@ -249,53 +286,189 @@ var thermostat_schedule = zod.z.object({
 
 // src/lib/seam/connect/models/devices/capability-properties/thermostat.ts
 var thermostat_capability_properties = zod.z.object({
-  temperature_fahrenheit: zod.z.number(),
-  temperature_celsius: zod.z.number(),
-  relative_humidity: zod.z.number().min(0).max(1),
-  available_hvac_mode_settings: zod.z.array(hvac_mode_setting),
-  available_fan_mode_settings: zod.z.array(fan_mode_setting),
-  is_heating: zod.z.boolean(),
-  is_cooling: zod.z.boolean(),
-  is_fan_running: zod.z.boolean(),
+  temperature_fahrenheit: zod.z.number().describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Reported temperature in \xB0F.
+          `),
+  temperature_celsius: zod.z.number().describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Reported temperature in \xB0C.
+          `),
+  relative_humidity: zod.z.number().min(0).max(1).describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Reported relative humidity, as a value between 0 and 1, inclusive.
+          `),
+  available_hvac_mode_settings: zod.z.array(hvac_mode_setting).describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          HVAC mode settings that the thermostat supports.
+          `),
+  available_fan_mode_settings: zod.z.array(fan_mode_setting).describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Fan mode settings that the thermostat supports.
+          `),
+  is_heating: zod.z.boolean().describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Indicates whether the connected HVAC system is currently heating, as reported by the thermostat.
+          `),
+  is_cooling: zod.z.boolean().describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Indicates whether the connected HVAC system is currently cooling, as reported by the thermostat.
+          `),
+  is_fan_running: zod.z.boolean().describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Indicates whether the fan in the connected HVAC system is currently running, as reported by the thermostat.
+          `),
   fan_mode_setting: fan_mode_setting.describe(`
       ---
-      deprecated: use current_climate_setting.fan_mode_setting instead.
+      deprecated: Use \`current_climate_setting.fan_mode_setting\` instead.
+      property_group_key: thermostats
       ---
     `),
   /**
    * this is true if the current thermostat settings differ that what is on seam, and `current_climate_setting.manual_override_allowed: true`
    */
-  is_temporary_manual_override_active: zod.z.boolean(),
+  is_temporary_manual_override_active: zod.z.boolean().describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          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\`.
+          `),
   /**
    * can be derived from `fallback_climate_preset_key`, or `active_thermostat_schedule` if one is active
    */
-  current_climate_setting: climate_setting,
+  current_climate_setting: climate_setting.describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Current climate setting.
+          `),
   default_climate_setting: climate_setting.describe(`
       ---
       deprecated: use fallback_climate_preset_key to specify a fallback climate preset instead.
+      property_group_key: thermostats
       ---
     `),
-  available_climate_presets: zod.z.array(climate_preset),
-  fallback_climate_preset_key: zod.z.string().min(1).nullable().default(null),
-  active_thermostat_schedule: thermostat_schedule.nullable().default(null),
-  thermostat_daily_programs: zod.z.array(thermostat_daily_program).optional(),
-  thermostat_weekly_program: thermostat_weekly_program.nullable().optional(),
-  min_cooling_set_point_celsius: zod.z.number(),
-  min_cooling_set_point_fahrenheit: zod.z.number(),
-  max_cooling_set_point_celsius: zod.z.number(),
-  max_cooling_set_point_fahrenheit: zod.z.number(),
-  min_heating_set_point_celsius: zod.z.number(),
-  min_heating_set_point_fahrenheit: zod.z.number(),
-  max_heating_set_point_celsius: zod.z.number(),
-  max_heating_set_point_fahrenheit: zod.z.number(),
-  min_heating_cooling_delta_celsius: zod.z.number(),
-  min_heating_cooling_delta_fahrenheit: zod.z.number(),
+  available_climate_presets: zod.z.array(climate_preset).describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Available [climate presets](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) for the thermostat.
+          `),
+  fallback_climate_preset_key: zod.z.string().min(1).nullable().default(null).describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Key of the [fallback climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets/setting-the-fallback-climate-preset) for the thermostat.
+          `),
+  active_thermostat_schedule: thermostat_schedule.nullable().default(null).describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Active [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules).
+          `),
+  thermostat_daily_programs: zod.z.array(thermostat_daily_program).optional().describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Configured [daily programs](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-programs) for the thermostat.
+          `),
+  thermostat_weekly_program: thermostat_weekly_program.nullable().optional().describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Current [weekly program](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-programs) for the thermostat.
+          `),
+  min_cooling_set_point_celsius: zod.z.number().describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Minimum [cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points#cooling-set-point) in \xB0C.
+          `),
+  min_cooling_set_point_fahrenheit: zod.z.number().describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Minimum [cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points#cooling-set-point) in \xB0F.
+          `),
+  max_cooling_set_point_celsius: zod.z.number().describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Maximum [cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points#cooling-set-point) in \xB0C.
+          `),
+  max_cooling_set_point_fahrenheit: zod.z.number().describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Maximum [cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points#cooling-set-point) in \xB0F.
+          `),
+  min_heating_set_point_celsius: zod.z.number().describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Minimum [heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points#heating-set-point) in \xB0C.
+          `),
+  min_heating_set_point_fahrenheit: zod.z.number().describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Minimum [heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points#heating-set-point) in \xB0F.
+          `),
+  max_heating_set_point_celsius: zod.z.number().describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Maximum [heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points#heating-set-point) in \xB0C.
+          `),
+  max_heating_set_point_fahrenheit: zod.z.number().describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Maximum [heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points#heating-set-point) in \xB0F.
+          `),
+  min_heating_cooling_delta_celsius: zod.z.number().describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Minimum [temperature difference](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points#minimum-heating-cooling-temperature-delta) in \xB0C between the cooling and heating set points when in heat-cool (auto) mode.
+          `),
+  min_heating_cooling_delta_fahrenheit: zod.z.number().describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Minimum [temperature difference](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points#minimum-heating-cooling-temperature-delta) in \xB0F between the cooling and heating set points when in heat-cool (auto) mode.
+          `),
   temperature_threshold: zod.z.object({
-    lower_limit_celsius: zod.z.number().nullable(),
-    lower_limit_fahrenheit: zod.z.number().nullable(),
-    upper_limit_celsius: zod.z.number().nullable(),
-    upper_limit_fahrenheit: zod.z.number().nullable()
-  }).optional()
+    lower_limit_celsius: zod.z.number().nullable().describe(`Lower limit in \xB0C within the current [temperature threshold](https://docs.seam.co/latest/capability-guides/thermostats/setting-and-monitoring-temperature-thresholds) set for the thermostat.
+          `),
+    lower_limit_fahrenheit: zod.z.number().nullable().describe(`Lower limit in \xB0F within the current [temperature threshold](https://docs.seam.co/latest/capability-guides/thermostats/setting-and-monitoring-temperature-thresholds) set for the thermostat.
+          `),
+    upper_limit_celsius: zod.z.number().nullable().describe(`Upper limit in \xB0C within the current [temperature threshold](https://docs.seam.co/latest/capability-guides/thermostats/setting-and-monitoring-temperature-thresholds) set for the thermostat.
+          `),
+    upper_limit_fahrenheit: zod.z.number().nullable().describe(`Upper limit in \xB0F within the current [temperature threshold](https://docs.seam.co/latest/capability-guides/thermostats/setting-and-monitoring-temperature-thresholds) set for the thermostat.
+          `)
+  }).optional().describe(`
+          ---
+          property_group_key: thermostats
+          ---
+          Current [temperature threshold](https://docs.seam.co/latest/capability-guides/thermostats/setting-and-monitoring-temperature-thresholds) set for the thermostat.
+          `)
 }).partial();
 
 // src/lib/seam/connect/models/devices/capability-properties/index.ts
@@ -682,251 +855,452 @@ var connected_account = zod.z.object({
   Represents a [connected account](https://docs.seam.co/latest/core-concepts/connected-accounts). A connected account is an external third-party account to which your user has authorized Seam to get access, for example, an August account with a list of door locks.
 `);
 var dormakaba_oracode_time_slot = zod.z.object({
-  name: zod.z.string(),
-  prefix: zod.z.number(),
+  name: zod.z.string().describe(`Name of a time slot for a dormakaba Oracode device.
+          `),
+  prefix: zod.z.number().describe(`Prefix for a time slot for a dormakaba Oracode device.
+          `),
   // Seam TOD
-  check_in_time: zod.z.string(),
+  check_in_time: zod.z.string().describe(`Check in time for a time slot for a dormakaba Oracode device.
+          `),
   // Seam TOD
-  check_out_time: zod.z.string(),
-  is_24_hour: zod.z.boolean(),
-  is_biweekly_mode: zod.z.boolean(),
-  is_one_shot: zod.z.boolean(),
-  is_master: zod.z.boolean(),
-  ext_dormakaba_oracode_user_level_prefix: zod.z.number(),
-  dormakaba_oracode_user_level_id: zod.z.string().uuid()
-});
+  check_out_time: zod.z.string().describe(`Checkout time for a time slot for a dormakaba Oracode device.
+          `),
+  is_24_hour: zod.z.boolean().describe(`Indicates whether a time slot for a dormakaba Oracode device is a 24-hour time slot.
+          `),
+  is_biweekly_mode: zod.z.boolean().describe(`Indicates whether a time slot for a dormakaba Oracode device is in biweekly mode.
+          `),
+  is_one_shot: zod.z.boolean().describe(`Indicates whether a time slot for a dormakaba Oracode device is a one-shot time slot.
+          `),
+  is_master: zod.z.boolean().describe(`Indicates whether a time slot for a dormakaba Oracode device is a master time slot.
+          `),
+  ext_dormakaba_oracode_user_level_prefix: zod.z.number().describe(`Prefix for a user level for a dormakaba Oracode device.
+          `),
+  dormakaba_oracode_user_level_id: zod.z.string().uuid().describe(`ID of a user level for a dormakaba Oracode device.
+          `)
+}).describe(`Time slot for a dormakaba Oracode device.
+          `);
 var device_metadata = zod.z.object({
   august_metadata: zod.z.object({
-    lock_id: zod.z.string(),
-    lock_name: zod.z.string(),
-    house_name: zod.z.string(),
-    has_keypad: zod.z.boolean(),
-    keypad_battery_level: zod.z.string().optional(),
-    model: zod.z.string().optional(),
-    house_id: zod.z.string().optional()
-  }),
+    lock_id: zod.z.string().describe(`Lock ID for an August device.
+          `),
+    lock_name: zod.z.string().describe(`Lock name for an August device.
+          `),
+    house_name: zod.z.string().describe(`House name for an August device.
+          `),
+    has_keypad: zod.z.boolean().describe(`Indicates whether an August device has a keypad.
+          `),
+    keypad_battery_level: zod.z.string().optional().describe(`Keypad battery level for an August device.
+          `),
+    model: zod.z.string().optional().describe(`Model for an August device.
+          `),
+    house_id: zod.z.string().optional().describe(`House ID for an August device.
+          `)
+  }).describe(`Metadata for an August device.
+          `),
   avigilon_alta_metadata: zod.z.object({
-    entry_name: zod.z.string(),
-    org_name: zod.z.string(),
-    zone_id: zod.z.number(),
-    zone_name: zod.z.string(),
-    site_id: zod.z.number(),
-    site_name: zod.z.string(),
-    entry_relays_total_count: zod.z.number()
-  }),
+    entry_name: zod.z.string().describe(`Entry name for an Avigilon Alta system.
+          `),
+    org_name: zod.z.string().describe(`Organization name for an Avigilon Alta system.
+          `),
+    zone_id: zod.z.number().describe(`Zone ID for an Avigilon Alta system.
+          `),
+    zone_name: zod.z.string().describe(`Zone name for an Avigilon Alta system.
+          `),
+    site_id: zod.z.number().describe(`Site ID for an Avigilon Alta system.
+          `),
+    site_name: zod.z.string().describe(`Site name for an Avigilon Alta system.
+          `),
+    entry_relays_total_count: zod.z.number().describe(`Total count of entry relays for an Avigilon Alta system.
+          `)
+  }).describe(`Metadata for an Avigilon Alta system.
+          `),
   schlage_metadata: zod.z.object({
-    device_id: zod.z.string(),
-    device_name: zod.z.string(),
-    model: zod.z.string().optional()
-  }),
+    device_id: zod.z.string().describe(`Device ID for a Schlage device.
+          `),
+    device_name: zod.z.string().describe(`Device name for a Schlage device.
+          `),
+    model: zod.z.string().optional().describe(`Model for a Schlage device.
+          `)
+  }).describe(`Metadata for a Schlage device.
+          `),
   smartthings_metadata: zod.z.object({
-    device_id: zod.z.string(),
-    device_name: zod.z.string(),
-    model: zod.z.string().optional(),
-    location_id: zod.z.string().optional()
-  }),
+    device_id: zod.z.string().describe(`Device ID for a SmartThings device.
+          `),
+    device_name: zod.z.string().describe(`Device name for a SmartThings device.
+          `),
+    model: zod.z.string().optional().describe(`Model for a SmartThings device.
+          `),
+    location_id: zod.z.string().optional().describe(`Location ID for a SmartThings device.
+          `)
+  }).describe(`Metadata for a SmartThings device.
+          `),
   lockly_metadata: zod.z.object({
-    device_id: zod.z.string(),
-    device_name: zod.z.string(),
-    model: zod.z.string().optional()
-  }),
+    device_id: zod.z.string().describe(`Device ID for a Lockly device.
+          `),
+    device_name: zod.z.string().describe(`Device name for a Lockly device.
+          `),
+    model: zod.z.string().optional().describe(`Model for a Lockly device.
+          `)
+  }).describe(`Metadata for a Lockly device.
+          `),
   nuki_metadata: zod.z.object({
-    device_id: zod.z.string(),
-    device_name: zod.z.string(),
-    keypad_battery_critical: zod.z.boolean().optional(),
-    keypad_paired: zod.z.boolean().optional(),
-    keypad_2_paired: zod.z.boolean().optional()
-  }),
+    device_id: zod.z.string().describe(`Device ID for a Nuki device.
+          `),
+    device_name: zod.z.string().describe(`Device name for a Nuki device.
+          `),
+    keypad_battery_critical: zod.z.boolean().optional().describe(`Indicates whether the keypad battery is in a critical state for a Nuki device.
+          `),
+    keypad_paired: zod.z.boolean().optional().describe(`Indicates whether the keypad is paired for a Nuki device.
+          `),
+    keypad_2_paired: zod.z.boolean().optional().describe(`Indicates whether keypad 2 is paired for a Nuki device.
+          `)
+  }).describe(`Metadata for a Nuki device.
+          `),
   kwikset_metadata: zod.z.object({
-    device_id: zod.z.string(),
-    device_name: zod.z.string(),
-    model_number: zod.z.string()
-  }),
+    device_id: zod.z.string().describe(`Device ID for a Kwikset device.
+          `),
+    device_name: zod.z.string().describe(`Device name for a Kwikset device.
+          `),
+    model_number: zod.z.string().describe(`Model number for a Kwikset device.
+          `)
+  }).describe(`Metadata for a Kwikset device.
+          `),
   salto_metadata: zod.z.object({
-    lock_id: zod.z.string(),
-    customer_reference: zod.z.string(),
-    lock_type: zod.z.string(),
-    battery_level: zod.z.string(),
-    locked_state: zod.z.string(),
-    model: zod.z.string().optional()
+    lock_id: zod.z.string().describe(`Lock ID for a Salto device.
+          `),
+    customer_reference: zod.z.string().describe(`Customer reference for a Salto device.
+          `),
+    lock_type: zod.z.string().describe(`Lock type for a Salto device.
+          `),
+    battery_level: zod.z.string().describe(`Battery level for a Salto device.
+          `),
+    locked_state: zod.z.string().describe(`Locked state for a Salto device.
+          `),
+    model: zod.z.string().optional().describe(`Model for a Salto device.
+          `)
   }).describe(`
     ---
     deprecated: Use \`salto_ks_metadata \` instead.
+    ---
+    Metada for a Salto device.
     `),
   salto_ks_metadata: zod.z.object({
-    lock_id: zod.z.string(),
-    customer_reference: zod.z.string(),
-    lock_type: zod.z.string(),
-    battery_level: zod.z.string(),
-    locked_state: zod.z.string(),
-    model: zod.z.string().optional()
-  }),
+    lock_id: zod.z.string().describe(`Lock ID for a Salto KS device.
+          `),
+    customer_reference: zod.z.string().describe(`Customer reference for a Salto KS device.
+          `),
+    lock_type: zod.z.string().describe(`Lock type for a Salto KS device.
+          `),
+    battery_level: zod.z.string().describe(`Battery level for a Salto KS device.
+          `),
+    locked_state: zod.z.string().describe(`Locked state for a Salto KS device.
+          `),
+    model: zod.z.string().optional().describe(`Model for a Salto KS device.
+          `)
+  }).describe(`Metadata for a Salto KS device.
+          `),
   genie_metadata: zod.z.object({
-    device_name: zod.z.string(),
-    door_name: zod.z.string()
-  }),
+    device_name: zod.z.string().describe(`Lock name for a Genie device.
+          `),
+    door_name: zod.z.string().describe(`Door name for a Genie device.
+          `)
+  }).describe(`Metadata for a Genie device.
+          `),
   brivo_metadata: zod.z.object({
-    device_name: zod.z.string()
-  }),
+    device_name: zod.z.string().describe(`Device name for a Brivo device.
+          `)
+  }).describe(`Metadata for a Brivo device.
+          `),
   igloo_metadata: zod.z.object({
-    device_id: zod.z.string(),
-    bridge_id: zod.z.string(),
-    model: zod.z.string().optional()
-  }),
+    device_id: zod.z.string().describe(`Device ID for an igloo device.
+          `),
+    bridge_id: zod.z.string().describe(`Bridge ID for an igloo device.
+          `),
+    model: zod.z.string().optional().describe(`Model for an igloo device.
+          `)
+  }).describe(`Metadata for an igloo device.
+          `),
   noiseaware_metadata: zod.z.object({
-    device_model: zod.z.enum(["indoor", "outdoor"]),
-    noise_level_nrs: zod.z.number(),
-    noise_level_decibel: zod.z.number(),
-    device_name: zod.z.string(),
-    device_id: zod.z.string()
-  }),
+    device_model: zod.z.enum(["indoor", "outdoor"]).describe(`Device model for a NoiseAware device.
+          `),
+    noise_level_nrs: zod.z.number().describe(`Noise level, expressed as a Noise Risk Score (NRS), for a NoiseAware device.
+          `),
+    noise_level_decibel: zod.z.number().describe(`Noise level, in decibels, for a NoiseAware device.
+          `),
+    device_name: zod.z.string().describe(`Device name for a NoiseAware device.
+          `),
+    device_id: zod.z.string().describe(`Device ID for a NoiseAware device.
+          `)
+  }).describe(`Metadata for a NoiseAware device.
+          `),
   minut_metadata: zod.z.object({
-    device_id: zod.z.string(),
-    device_name: zod.z.string(),
+    device_id: zod.z.string().describe(`Device ID for a Minut device.
+          `),
+    device_name: zod.z.string().describe(`Device name for a Minut device.
+          `),
     latest_sensor_values: zod.z.object({
       temperature: zod.z.object({
-        time: zod.z.string(),
-        value: zod.z.number()
-      }),
+        time: zod.z.string().describe(`Time of latest temperature reading for a Minut device.
+          `),
+        value: zod.z.number().describe(`Value of latest temperature reading for a Minut device.
+          `)
+      }).describe(`Latest temperature reading for a Minut device.
+          `),
       sound: zod.z.object({
-        time: zod.z.string(),
-        value: zod.z.number()
-      }),
+        time: zod.z.string().describe(`Time of latest sound reading for a Minut device.
+          `),
+        value: zod.z.number().describe(`Value of latest sound reading for a Minut device.
+          `)
+      }).describe(`Latest sound reading for a Minut device.
+          `),
       humidity: zod.z.object({
-        time: zod.z.string(),
-        value: zod.z.number()
-      }),
+        time: zod.z.string().describe(`Time of latest humidity reading for a Minut device.
+          `),
+        value: zod.z.number().describe(`Value of latest humidity reading for a Minut device.
+          `)
+      }).describe(`Latest humidity reading for a Minut device.
+          `),
       pressure: zod.z.object({
-        time: zod.z.string(),
-        value: zod.z.number()
-      }),
+        time: zod.z.string().describe(`Time of latest pressure reading for a Minut device.
+          `),
+        value: zod.z.number().describe(`Value of latest pressure reading for a Minut device.
+          `)
+      }).describe(`Latest pressure reading for a Minut device.
+          `),
       accelerometer_z: zod.z.object({
-        time: zod.z.string(),
-        value: zod.z.number()
-      })
-    })
-  }),
+        time: zod.z.string().describe(`Time of latest accelerometer Z-axis reading for a Minut device.
+          `),
+        value: zod.z.number().describe(`Value of latest accelerometer Z-axis reading for a Minut device.
+          `)
+      }).describe(`Latest accelerometer Z-axis reading for a Minut device.
+          `)
+    }).describe(`Latest sensor values for a Minut device.
+          `)
+  }).describe(`Metadata for a Minut device.
+          `),
   four_suites_metadata: zod.z.object({
-    device_id: zod.z.number(),
-    device_name: zod.z.string(),
-    reclose_delay_in_seconds: zod.z.number()
-  }),
+    device_id: zod.z.number().describe(`Device ID for a 4SUITES device.
+          `),
+    device_name: zod.z.string().describe(`Device name for a 4SUITES device.
+          `),
+    reclose_delay_in_seconds: zod.z.number().describe(`Reclose delay, in seconds, for a 4SUITES device.
+          `)
+  }).describe(`Metadata for a 4SUITES device.
+          `),
   two_n_metadata: zod.z.object({
-    device_id: zod.z.number(),
-    device_name: zod.z.string()
-  }),
+    device_id: zod.z.number().describe(`Device ID for a 2N device.
+          `),
+    device_name: zod.z.string().describe(`Device name for a 2N device.
+          `)
+  }).describe(`Metadata for a 2N device.
+          `),
   controlbyweb_metadata: zod.z.object({
-    device_id: zod.z.string(),
-    device_name: zod.z.string(),
-    relay_name: zod.z.string().nullable()
-  }),
+    device_id: zod.z.string().describe(`Device ID for a ControlByWeb device.
+          `),
+    device_name: zod.z.string().describe(`Device name for a ControlByWeb device.
+          `),
+    relay_name: zod.z.string().nullable().describe(`Relay name for a ControlByWeb device.
+          `)
+  }).describe(`Metadata for a ControlByWeb device.
+          `),
   ttlock_metadata: zod.z.object({
-    lock_id: zod.z.number(),
-    lock_alias: zod.z.string(),
-    feature_value: zod.z.string(),
+    lock_id: zod.z.number().describe(`Lock ID for a TTLock device.
+          `),
+    lock_alias: zod.z.string().describe(`Lock alias for a TTLock device.
+          `),
+    feature_value: zod.z.string().describe(`Feature value for a TTLock device.
+          `),
     features: zod.z.object({
-      passcode: zod.z.boolean(),
-      passcode_management: zod.z.boolean(),
-      unlock_via_gateway: zod.z.boolean(),
-      lock_command: zod.z.boolean(),
-      incomplete_keyboard_passcode: zod.z.boolean(),
-      wifi: zod.z.boolean()
-    }),
-    has_gateway: zod.z.boolean().optional(),
+      passcode: zod.z.boolean().describe(`Indicates whether a TTLock device supports a passcode.
+          `),
+      passcode_management: zod.z.boolean().describe(`Indicates whether a TTLock device supports passcode management.
+          `),
+      unlock_via_gateway: zod.z.boolean().describe(`Indicates whether a TTLock device supports unlock via gateway.
+          `),
+      lock_command: zod.z.boolean().describe(`Indicates whether a TTLock device supports the lock command.
+          `),
+      incomplete_keyboard_passcode: zod.z.boolean().describe(`Indicates whether a TTLock device supports an incomplete keyboard passcode.
+          `),
+      wifi: zod.z.boolean().describe(`Indicates whether a TTLock device supports Wi-Fi.
+          `)
+    }).describe(`Features for a TTLock device.
+          `),
+    has_gateway: zod.z.boolean().optional().describe(`Indicates whether a TTLock device has a gateway.
+          `),
     wireless_keypads: zod.z.array(
       zod.z.object({
-        wireless_keypad_id: zod.z.number(),
-        wireless_keypad_name: zod.z.string()
+        wireless_keypad_id: zod.z.number().describe(`ID for a wireless keypad for a TTLock device.
+          `),
+        wireless_keypad_name: zod.z.string().describe(`Name for a wireless keypad for a TTLock device.
+          `)
       })
-    ).optional()
-  }),
+    ).optional().describe(`Wireless keypads for a TTLock device.
+          `)
+  }).describe(`Metadata for a TTLock device.
+          `),
   seam_bridge_metadata: zod.z.object({
-    unlock_method: zod.z.enum(["bridge", "doorking"]).optional(),
-    device_num: zod.z.number(),
-    name: zod.z.string()
-  }),
+    unlock_method: zod.z.enum(["bridge", "doorking"]).optional().describe(`Unlock method for Seam Bridge.
+          `),
+    device_num: zod.z.number().describe(`Device number for Seam Bridge.
+          `),
+    name: zod.z.string().describe(`Name for Seam Bridge.
+          `)
+  }).describe(`Metadata for Seam Bridge.
+          `),
   igloohome_metadata: zod.z.object({
-    device_id: zod.z.string(),
-    device_name: zod.z.string(),
-    bridge_id: zod.z.string().optional(),
-    bridge_name: zod.z.string().optional(),
-    keypad_id: zod.z.string().optional()
-  }),
+    device_id: zod.z.string().describe(`Device ID for an igloohome device.
+          `),
+    device_name: zod.z.string().describe(`Device name for an igloohome device.
+          `),
+    bridge_id: zod.z.string().optional().describe(`Bridge ID for an igloohome device.
+          `),
+    bridge_name: zod.z.string().optional().describe(`Bridge name for an igloohome device.
+          `),
+    keypad_id: zod.z.string().optional().describe(`Keypad ID for an igloohome device.
+          `)
+  }).describe(`Metadata for an igloohome device.
+          `),
   nest_metadata: zod.z.object({
-    nest_device_id: zod.z.string(),
-    device_name: zod.z.string(),
+    nest_device_id: zod.z.string().describe(`Device ID for a Google Nest device.
+          `),
+    device_name: zod.z.string().describe(`Device name for a Google Nest device. Google sets this value.
+          `),
     // set by Google
-    device_custom_name: zod.z.string(),
+    device_custom_name: zod.z.string().describe(`Custom device name for a Google Nest device. The device owner sets this value.
+          `),
     // set by device owner
-    display_name: zod.z.string().optional()
-  }),
+    display_name: zod.z.string().optional().describe(`Display name for a Google Nest device.
+          `)
+  }).describe(`Metadata for a Google Nest device.
+          `),
   ecobee_metadata: zod.z.object({
-    ecobee_device_id: zod.z.string(),
-    device_name: zod.z.string()
-  }),
+    ecobee_device_id: zod.z.string().describe(`Device ID for an ecobee device.
+          `),
+    device_name: zod.z.string().describe(`Device name for an ecobee device.
+          `)
+  }).describe(`Metadata for an ecobee device.
+          `),
   honeywell_resideo_metadata: zod.z.object({
-    honeywell_resideo_device_id: zod.z.string(),
-    device_name: zod.z.string()
-  }),
+    honeywell_resideo_device_id: zod.z.string().describe(`Device ID for a Honeywell Resideo device.
+          `),
+    device_name: zod.z.string().describe(`Device name for a Honeywell Resideo device.
+          `)
+  }).describe(`Metadata for a Honeywell Resideo device.
+          `),
   hubitat_metadata: zod.z.object({
-    device_id: zod.z.string(),
-    device_name: zod.z.string(),
-    device_label: zod.z.string()
-  }),
+    device_id: zod.z.string().describe(`Device ID for a Hubitat device.
+          `),
+    device_name: zod.z.string().describe(`Device name for a Hubitat device.
+          `),
+    device_label: zod.z.string().describe(`Device label for a Hubitat device.
+          `)
+  }).describe(`Metadata for a Hubitat device.
+          `),
   dormakaba_oracode_metadata: zod.z.object({
-    door_id: zod.z.number().optional(),
-    door_name: zod.z.string(),
-    device_id: zod.z.number().or(zod.z.string()).optional(),
-    door_is_wireless: zod.z.boolean(),
-    site_id: zod.z.number().nullable().describe("@DEPRECATED"),
-    site_name: zod.z.string(),
-    iana_timezone: zod.z.string().optional(),
-    predefined_time_slots: zod.z.array(dormakaba_oracode_time_slot).optional()
-  }),
+    door_id: zod.z.number().optional().describe(`Door ID for a dormakaba Oracode device.
+          `),
+    door_name: zod.z.string().describe(`Door name for a dormakaba Oracode device.
+          `),
+    device_id: zod.z.number().or(zod.z.string()).optional().describe(`Device ID for a dormakaba Oracode device.
+          `),
+    door_is_wireless: zod.z.boolean().describe(`Indicates whether a door is wireless for a dormakaba Oracode device.
+          `),
+    site_id: zod.z.number().nullable().describe(`
+          ---
+          deprecated: Previously marked as "@DEPRECATED."
+          ---
+          Site ID for a dormakaba Oracode device.
+          `),
+    site_name: zod.z.string().describe(`Site name for a dormakaba Oracode device.
+          `),
+    iana_timezone: zod.z.string().optional().describe(`IANA time zone for a dormakaba Oracode device.
+          `),
+    predefined_time_slots: zod.z.array(dormakaba_oracode_time_slot).optional().describe(`Predefined time slots for a dormakaba Oracode device.
+          `)
+  }).describe(`Metadata for a dormakaba Oracode device.
+          `),
   wyze_metadata: zod.z.object({
-    device_id: zod.z.string(),
-    device_name: zod.z.string(),
-    product_name: zod.z.string(),
-    product_type: zod.z.string(),
-    product_model: zod.z.string(),
-    device_info_model: zod.z.string(),
-    keypad_uuid: zod.z.string().optional(),
-    locker_status_hardlock: zod.z.number().optional()
-  }),
+    device_id: zod.z.string().describe(`Device ID for a Wyze device.
+          `),
+    device_name: zod.z.string().describe(`Device name for a Wyze device.
+          `),
+    product_name: zod.z.string().describe(`Product name for a Wyze device.
+          `),
+    product_type: zod.z.string().describe(`Product type for a Wyze device.
+          `),
+    product_model: zod.z.string().describe(`Product model for a Wyze device.
+          `),
+    device_info_model: zod.z.string().describe(`Device information model for a Wyze device.
+          `),
+    keypad_uuid: zod.z.string().optional().describe(`Keypad UUID for a Wyze device.
+          `),
+    locker_status_hardlock: zod.z.number().optional().describe(`Locker status (hardlock) for a Wyze device.
+          `)
+  }).describe(`Metadata for a Wyze device.
+          `),
   tedee_metadata: zod.z.object({
-    device_id: zod.z.number(),
-    serial_number: zod.z.string(),
-    device_name: zod.z.string(),
-    device_model: zod.z.string(),
-    bridge_id: zod.z.number(),
-    bridge_name: zod.z.string(),
-    keypad_id: zod.z.number().optional()
-  }),
+    device_id: zod.z.number().describe(`Device ID for a Tedee device.
+          `),
+    serial_number: zod.z.string().describe(`Serial number for a Tedee device.
+          `),
+    device_name: zod.z.string().describe(`Device name for a Tedee device.
+          `),
+    device_model: zod.z.string().describe(`Device model for a Tedee device.
+          `),
+    bridge_id: zod.z.number().describe(`Bridge ID for a Tedee device.
+          `),
+    bridge_name: zod.z.string().describe(`Bridge name for a Tedee device.
+          `),
+    keypad_id: zod.z.number().optional().describe(`Keypad ID for a Tedee device.
+          `)
+  }).describe(`Metadata for a Tedee device.
+          `),
   visionline_metadata: zod.z.object({
-    encoder_id: zod.z.string()
-  }),
+    encoder_id: zod.z.string().describe(`Encoder ID for an ASSA ABLOY Visionline system.
+          `)
+  }).describe(`Metadata for an ASSA ABLOY Visionline system.
+          `),
   akiles_metadata: zod.z.object({
-    gadget_name: zod.z.string(),
-    gadget_id: zod.z.string(),
-    product_name: zod.z.string(),
+    gadget_name: zod.z.string().describe(`Gadget name for an Akiles device.
+          `),
+    gadget_id: zod.z.string().describe(`Gadget ID for an Akiles device.
+          `),
+    product_name: zod.z.string().describe(`Product name for an Akiles device.
+          `),
     /**
      * Group ID to add users to for this device
      */
-    _member_group_id: zod.z.string().optional()
-  }),
+    _member_group_id: zod.z.string().optional().describe(`Group ID to which to add users for an Akiles device.
+          `)
+  }).describe(`Metadata for an Akiles device.
+          `),
   assa_abloy_vostio_metadata: zod.z.object({
-    encoder_name: zod.z.string()
-  }),
+    encoder_name: zod.z.string().describe(`Encoder name for an ASSA ABLOY Vostio system.
+          `)
+  }).describe(`Metadata for an ASSA ABLOY Vostio system.
+          `),
   tado_metadata: zod.z.object({
-    serial_no: zod.z.string(),
-    device_type: zod.z.string()
-  }),
+    serial_no: zod.z.string().describe(`Serial number for a tado\xB0 device.
+          `),
+    device_type: zod.z.string().describe(`Device type for a tado\xB0 device.
+          `)
+  }).describe(`Metadata for a tado\xB0 device.
+          `),
   sensi_metadata: zod.z.object({
-    device_id: zod.z.string(),
-    device_name: zod.z.string(),
-    product_type: zod.z.string()
-  })
-}).partial();
+    device_id: zod.z.string().describe(`Device ID for a Sensi device.
+          `),
+    device_name: zod.z.string().describe(`Device name for a Sensi device.
+          `),
+    product_type: zod.z.string().describe(`Product type for a Sensi device.
+          `)
+  }).describe(`Metadata for a Sensi device.
+          `)
+}).partial().describe(`
+          ---
+          property_group_key: provider_metadata
+          ---
+          Provider-specific metadata.
+          `);
 var LOCK_DEVICE_TYPE = {
   AKUVOX_LOCK: "akuvox_lock",
   AUGUST_LOCK: "august_lock",
@@ -958,14 +1332,16 @@ var LOCK_DEVICE_TYPE = {
 };
 var lock_device_type = zod.z.enum(
   Object.values(LOCK_DEVICE_TYPE)
-);
+).describe(`Device type for smartlocks.
+          `);
 var NOISE_SENSOR_DEVICE_TYPE = {
   NOISEAWARE_ACTIVITY_ZONE: "noiseaware_activity_zone",
   MINUT_SENSOR: "minut_sensor"
 };
 var noise_sensor_device_type = zod.z.enum(
   Object.values(NOISE_SENSOR_DEVICE_TYPE)
-);
+).describe(`Device type for noise sensors.
+          `);
 var THERMOSTAT_DEVICE_TYPE = {
   ECOBEE_THERMOSTAT: "ecobee_thermostat",
   NEST_THERMOSTAT: "nest_thermostat",
@@ -976,7 +1352,8 @@ var THERMOSTAT_DEVICE_TYPE = {
 };
 var thermostat_device_type = zod.z.enum(
   Object.values(THERMOSTAT_DEVICE_TYPE)
-);
+).describe(`Device type for thermostats.
+          `);
 var PHONE_DEVICE_TYPE = {
   IOS_PHONE: "ios_phone",
   ANDROID_PHONE: "android_phone"
@@ -984,7 +1361,10 @@ var PHONE_DEVICE_TYPE = {
 var PHONE_DEVICE_TYPE_LIST = Object.values(
   PHONE_DEVICE_TYPE
 );
-var phone_device_type = zod.z.enum(Object.values(PHONE_DEVICE_TYPE_LIST)).describe("Type of phone.");
+var phone_device_type = zod.z.enum(
+  Object.values(PHONE_DEVICE_TYPE_LIST)
+).describe(`Device type for phones.
+          `);
 var any_device_type = zod.z.union([
   lock_device_type,
   noise_sensor_device_type,
@@ -1008,7 +1388,9 @@ var phone_specific_properties = zod.z.object({
       "Indicates whether the credential service has an active associated phone."
     )
   }).optional().describe("Salto Space credential service metadata for the phone.")
-}).describe("Properties of the phone.");
+}).describe(`
+          Properties of the phone.
+          `);
 
 // src/lib/seam/connect/models/devices/device.ts
 var device_capability_flags2 = models_exports.device_capability_flags.extend({
@@ -1016,7 +1398,8 @@ var device_capability_flags2 = models_exports.device_capability_flags.extend({
   can_simulate_connection: zod.z.boolean().optional(),
   can_simulate_disconnection: zod.z.boolean().optional()
 });
-var battery_status = zod.z.enum(["critical", "low", "good", "full"]);
+var battery_status = zod.z.enum(["critical", "low", "good", "full"]).describe(`Represents the current status of the battery charge level. Values are \`critical\`, which indicates an extremely low level, suggesting imminent shutdown or an urgent need for charging; \`low\`, which signifies that the battery is under the preferred threshold and should be charged soon; \`good\`, which denotes a satisfactory charge level, adequate for normal use without the immediate need for recharging; and \`full\`, which represents a battery that is fully charged, providing the maximum duration of usage.
+          `);
 var common_device_error = zod.z.object({
   message: zod.z.string(),
   is_device_error: zod.z.literal(true),
@@ -1208,65 +1591,126 @@ var common_device_properties = zod.z.object({
       Name of the device.
       `),
   accessory_keypad: zod.z.object({
-    is_connected: zod.z.boolean().describe(
-      "Indicates if the accessory_keypad is connected to the device."
-    ),
+    is_connected: zod.z.boolean().describe(`Indicates if an accessory keypad is connected to the device.
+        `),
     battery: zod.z.object({
       level: zod.z.number().min(0).max(1)
-    }).optional().describe("Indicates if the keypad battery properties.")
-  }).optional().describe("Represents the accessory keypad state."),
+    }).optional().describe(`Keypad battery properties.
+          `)
+  }).optional().describe(`
+          ---
+          property_group_key: hardware
+          ---
+          Accessory keypad properties and state.
+          `),
   appearance: zod.z.object({
     name: zod.z.string().describe(
       "Name of the device as seen from the provider API and application, not settable through Seam."
     )
-  }),
+  }).describe(`
+          ---
+          property_group_key: hardware
+          ---
+          Appearance-related properties, as reported by the device.
+          `),
   model: zod.z.object({
-    can_connect_accessory_keypad: zod.z.boolean().optional().describe("Indicates whether the device can connect a accessory keypad."),
-    display_name: zod.z.string().describe("Display name of the device model."),
-    manufacturer_display_name: zod.z.string().describe(
-      "Display name that corresponds to the manufacturer-specific terminology for the device."
-    ),
-    has_built_in_keypad: zod.z.boolean().optional().describe(
-      "Indicates whether the device has a built in accessory keypad."
-    ),
-    offline_access_codes_supported: zod.z.boolean().optional().describe("Indicates whether the device supports offline access codes."),
-    online_access_codes_supported: zod.z.boolean().optional().describe("Indicates whether the device supports online access codes."),
-    accessory_keypad_supported: zod.z.boolean().optional().describe(
-      `
-      ---
-      deprecated: use device.properties.model.can_connect_accessory_keypad
-      ---
-      `
-    )
-  }),
-  has_direct_power: zod.z.boolean().optional().describe("Indicates whether the device has direct power."),
-  battery_level: zod.z.number().min(0).max(1).optional().describe(
-    "Indicates the battery level of the device as a decimal value between 0 and 1, inclusive."
-  ),
+    can_connect_accessory_keypad: zod.z.boolean().optional().describe(`
+          Indicates whether the device can connect a accessory keypad.
+      `),
+    display_name: zod.z.string().describe(`
+          Display name of the device model.
+      `),
+    manufacturer_display_name: zod.z.string().describe(`
+          Display name that corresponds to the manufacturer-specific terminology for the device.
+      `),
+    has_built_in_keypad: zod.z.boolean().optional().describe(`
+          Indicates whether the device has a built in accessory keypad.
+      `),
+    offline_access_codes_supported: zod.z.boolean().optional().describe(`
+          ---
+          deprecated: use device.can_program_offline_access_codes.
+          ---
+          `),
+    online_access_codes_supported: zod.z.boolean().optional().describe(`
+          ---
+          deprecated: use device.can_program_online_access_codes.
+          ---
+          `),
+    accessory_keypad_supported: zod.z.boolean().optional().describe(`
+        ---
+        deprecated: use device.properties.model.can_connect_accessory_keypad
+        ---
+        `)
+  }).describe(`Device model-related properties.`),
+  has_direct_power: zod.z.boolean().optional().describe(`
+          ---
+          property_group_key: hardware
+          ---
+          Indicates whether the device has direct power.
+          `),
+  battery_level: zod.z.number().min(0).max(1).optional().describe(`
+          ---
+          property_group_key: hardware
+          ---
+          Indicates the battery level of the device as a decimal value between 0 and 1, inclusive.
+          `),
   battery: zod.z.object({
-    level: zod.z.number().min(0).max(1),
+    level: zod.z.number().min(0).max(1).describe(`Battery charge level as a value between 0 and 1, inclusive.
+          `),
     status: battery_status
-  }).optional().describe(
-    'Represents the current status of the battery charge level. Values are "critical," which indicates an extremely low level, suggesting imminent shutdown or an urgent need for charging; "low," which signifies that the battery is under the preferred threshold and should be charged soon; "good," which denotes a satisfactory charge level, adequate for normal use without the immediate need for recharging; and "full," which represents a battery that is fully charged, providing the maximum duration of usage.'
-  ),
+  }).optional().describe(`
+          ---
+          property_group_key: hardware
+          ---
+          Represents the current status of the battery charge level.
+          `),
   // todo: use enum
-  manufacturer: zod.z.string().optional().describe(
-    "Manufacturer of the device. When a device, such as a smart lock, is connected through a smart hub, the manufacturer of the device might be different from that of the smart hub."
-  ),
-  image_url: zod.z.string().url().optional().describe("Image URL for the device."),
-  image_alt_text: zod.z.string().optional().describe("Alt text for the device image."),
-  serial_number: zod.z.string().optional().describe("Serial number of the device."),
+  manufacturer: zod.z.string().optional().describe(`
+          ---
+          property_group_key: hardware
+          ---
+          Manufacturer of the device. When a device, such as a smart lock, is connected through a smart hub, the manufacturer of the device might be different from that of the smart hub.
+    `),
+  image_url: zod.z.string().url().optional().describe(`
+          ---
+          property_group_key: hardware
+          ---
+          Image URL for the device.
+          `),
+  image_alt_text: zod.z.string().optional().describe(`
+          ---
+          property_group_key: hardware
+          ---
+          Alt text for the device image.
+          `),
+  serial_number: zod.z.string().optional().describe(`
+          ---
+          property_group_key: hardware
+          ---
+          Serial number of the device.
+          `),
   online_access_codes_enabled: zod.z.boolean().describe(
-    "Indicates whether it is currently possible to use online access codes for the device."
+    `
+          ---
+          property_group_key: access_codes
+          ---
+          Indicates whether it is currently possible to use online access codes for the device.
+          `
   ).optional(),
   offline_access_codes_enabled: zod.z.boolean().describe(
-    "Indicates whether it is currently possible to use offline access codes for the device."
+    `
+          ---
+          property_group_key: access_codes
+          ---
+          Indicates whether it is currently possible to use offline access codes for the device.
+          `
   ).optional(),
   // Deprecated legacy capability support props
   supports_accessory_keypad: zod.z.boolean().describe(
     `
       ---
       deprecated: use device.properties.model.can_connect_accessory_keypad
+      property_group_key: access_codes
       ---
       `
   ).optional(),
@@ -1274,13 +1718,26 @@ var common_device_properties = zod.z.object({
     `
       ---
       deprecated: use offline_access_codes_enabled
+      property_group_key: access_codes
       ---
       `
   ).optional(),
   noise_level_decibels: zod.z.number().describe(
-    "Indicates current noise level in decibels, if the device supports noise detection."
+    `
+          ---
+          property_group_key: noise_sensors
+          ---
+          Indicates current noise level in decibels, if the device supports noise detection.
+          `
   ).optional(),
-  currently_triggering_noise_threshold_ids: zod.z.array(zod.z.string()).describe("Array of noise threshold IDs that are currently triggering.").optional()
+  currently_triggering_noise_threshold_ids: zod.z.array(zod.z.string()).describe(
+    `
+          ---
+          property_group_key: noise_sensors
+          ---
+          Array of noise threshold IDs that are currently triggering.
+          `
+  ).optional()
 });
 var device_and_connected_account_error_options = [
   ...device_error.options,
@@ -1299,14 +1756,40 @@ var device = zod.z.object({
   display_name: zod.z.string().describe(
     "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."
   ),
-  capabilities_supported: zod.z.array(capabilities).describe(
-    '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; and "battery," which indicates that the device can manage battery life and health.'
-  ),
-  properties: common_device_properties.and(phone_specific_properties.partial()).and(device_metadata).and(capability_properties).describe("Properties of the device."),
+  capabilities_supported: zod.z.array(capabilities).describe(`
+        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](https://docs.seam.co/latest/capability-guides/device-and-system-capabilities#capability-flags).
+        `),
+  properties: common_device_properties.and(phone_specific_properties.partial()).and(device_metadata).and(capability_properties).describe(`
+    ---
+    property_groups:
+      locks:
+        name: Locks
+      access_codes:
+        name: Access Codes
+      thermostats:
+        name: Thermostats
+      hardware:
+        name: Hardware
+      noise_sensors:
+        name: Noise Sensors
+      phones:
+        name: Phones
+      provider_metadata:
+        name: Provider Metadata
+    ---
+    Properties of the device.
+  `),
   location: zod.z.object({
-    location_name: zod.z.string().optional().describe("Name of the device location."),
-    timezone: zod.z.string().optional().describe("Time zone of the device location.")
-  }).nullable().describe("Location information for the device."),
+    location_name: zod.z.string().optional().describe(`Name of the device location.
+          `),
+    timezone: zod.z.string().optional().describe(`Time zone of the device location.
+          `)
+  }).nullable().describe(`
+          ---
+          property_group_key: hardware
+          ---
+          Location information for the device.
+          `),
   connected_account_id: zod.z.string().uuid().describe(
     "Unique identifier for the account associated with the device."
   ),
@@ -1334,6 +1817,21 @@ var device = zod.z.object({
 }).merge(device_capability_flags2).describe(`
     ---
     route_path: /devices
+    property_groups:
+      locks:
+        name: Locks
+      access_codes:
+        name: Access Codes
+      thermostats:
+        name: Thermostats
+      hardware:
+        name: Hardware
+      noise_sensors:
+        name: Noise Sensors
+      phones:
+        name: Phones
+      provider_metadata:
+        name: Provider Metadata
     ---
     Represents a [device](https://docs.seam.co/latest/core-concepts/devices) that has been connected to Seam.
   `);
@@ -1482,10 +1980,44 @@ var unmanaged_device = device.pick({
     online_access_codes_enabled: true,
     offline_access_codes_enabled: true,
     model: true
-  })
+  }).describe(`
+    ---
+    property_groups:
+      locks:
+        name: locks
+      access_codes:
+        name: access codes
+      thermostats:
+        name: thermostats
+      hardware:
+        name: hardware
+      noise_sensors:
+        name: noise sensors
+      phones:
+        name: phones
+      provider_metadata:
+        name: provider metadata
+    ---
+    properties of the device.
+  `)
 }).merge(device_capability_flags2).describe(`
     ---
     route_path: /devices/unmanaged
+    property_groups:
+      locks:
+        name: Locks
+      access_codes:
+        name: Access Codes
+      thermostats:
+        name: Thermostats
+      hardware:
+        name: Hardware
+      noise_sensors:
+        name: Noise Sensors
+      phones:
+        name: Phones
+      provider_metadata:
+        name: Provider Metadata
     ---
     Represents an [unmanaged device](https://docs.seam.co/latest/core-concepts/devices/managed-and-unmanaged-devices). An unmanaged device has a limited set of visible properties and a subset of supported events. You cannot control an unmanaged device. Any [access codes](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes/migrating-existing-access-codes) on an unmanaged device are unmanaged. To control an unmanaged device with Seam, [convert it to a managed device](https://docs.seam.co/latest/core-concepts/devices/managed-and-unmanaged-devices#convert-an-unmanaged-device-to-managed).
   `);
@@ -11598,8 +12130,9 @@ var openapi_default = {
           can_simulate_removal: { type: "boolean" },
           can_turn_off_hvac: { type: "boolean" },
           capabilities_supported: {
-            description: '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; and "battery," which indicates that the device can manage battery life and health.',
+            description: "\n        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](https://docs.seam.co/latest/capability-guides/device-and-system-capabilities#capability-flags).\n        ",
             items: {
+              description: "\n        Collection of capabilities that the device supports when connected to Seam. **Important:** Superseded by [capability flags](https://docs.seam.co/latest/capability-guides/device-and-system-capabilities#capability-flags).\n        ",
               enum: [
                 "access_code",
                 "lock",
@@ -11638,6 +12171,7 @@ var openapi_default = {
             description: "Type of the device.",
             oneOf: [
               {
+                description: "Device type for smartlocks.\n          ",
                 enum: [
                   "akuvox_lock",
                   "august_lock",
@@ -11670,10 +12204,12 @@ var openapi_default = {
                 type: "string"
               },
               {
+                description: "Device type for noise sensors.\n          ",
                 enum: ["noiseaware_activity_zone", "minut_sensor"],
                 type: "string"
               },
               {
+                description: "Device type for thermostats.\n          ",
                 enum: [
                   "ecobee_thermostat",
                   "nest_thermostat",
@@ -11685,7 +12221,7 @@ var openapi_default = {
                 type: "string"
               },
               {
-                description: "Type of phone.",
+                description: "Device type for phones.\n          ",
                 enum: ["ios_phone", "android_phone"],
                 type: "string"
               }
@@ -12042,15 +12578,16 @@ var openapi_default = {
             nullable: true,
             properties: {
               location_name: {
-                description: "Name of the device location.",
+                description: "Name of the device location.\n          ",
                 type: "string"
               },
               timezone: {
-                description: "Time zone of the device location.",
+                description: "Time zone of the device location.\n          ",
                 type: "string"
               }
             },
-            type: "object"
+            type: "object",
+            "x-property-group-key": "hardware"
           },
           nickname: {
             description: "Optional nickname to describe the device, settable through Seam",
@@ -12065,10 +12602,10 @@ var openapi_default = {
                       {
                         properties: {
                           accessory_keypad: {
-                            description: "Represents the accessory keypad state.",
+                            description: "Accessory keypad properties and state.",
                             properties: {
                               battery: {
-                                description: "Indicates if the keypad battery properties.",
+                                description: "Keypad battery properties.\n          ",
                                 properties: {
                                   level: {
                                     format: "float",
@@ -12081,14 +12618,16 @@ var openapi_default = {
                                 type: "object"
                               },
                               is_connected: {
-                                description: "Indicates if the accessory_keypad is connected to the device.",
+                                description: "Indicates if an accessory keypad is connected to the device.\n        ",
                                 type: "boolean"
                               }
                             },
                             required: ["is_connected"],
-                            type: "object"
+                            type: "object",
+                            "x-property-group-key": "hardware"
                           },
                           appearance: {
+                            description: "Appearance-related properties, as reported by the device.",
                             properties: {
                               name: {
                                 description: "Name of the device as seen from the provider API and application, not settable through Seam.",
@@ -12096,55 +12635,66 @@ var openapi_default = {
                               }
                             },
                             required: ["name"],
-                            type: "object"
+                            type: "object",
+                            "x-property-group-key": "hardware"
                           },
                           battery: {
-                            description: 'Represents the current status of the battery charge level. Values are "critical," which indicates an extremely low level, suggesting imminent shutdown or an urgent need for charging; "low," which signifies that the battery is under the preferred threshold and should be charged soon; "good," which denotes a satisfactory charge level, adequate for normal use without the immediate need for recharging; and "full," which represents a battery that is fully charged, providing the maximum duration of usage.',
+                            description: "Represents the current status of the battery charge level.",
                             properties: {
                               level: {
+                                description: "Battery charge level as a value between 0 and 1, inclusive.\n          ",
                                 format: "float",
                                 maximum: 1,
                                 minimum: 0,
                                 type: "number"
                               },
                               status: {
+                                description: "Represents the current status of the battery charge level. Values are `critical`, which indicates an extremely low level, suggesting imminent shutdown or an urgent need for charging; `low`, which signifies that the battery is under the preferred threshold and should be charged soon; `good`, which denotes a satisfactory charge level, adequate for normal use without the immediate need for recharging; and `full`, which represents a battery that is fully charged, providing the maximum duration of usage.\n          ",
                                 enum: ["critical", "low", "good", "full"],
                                 type: "string"
                               }
                             },
                             required: ["level", "status"],
-                            type: "object"
+                            type: "object",
+                            "x-property-group-key": "hardware"
                           },
                           battery_level: {
                             description: "Indicates the battery level of the device as a decimal value between 0 and 1, inclusive.",
                             format: "float",
                             maximum: 1,
                             minimum: 0,
-                            type: "number"
+                            type: "number",
+                            "x-property-group-key": "hardware"
                           },
                           currently_triggering_noise_threshold_ids: {
                             description: "Array of noise threshold IDs that are currently triggering.",
                             items: { type: "string" },
-                            type: "array"
+                            type: "array",
+                            "x-property-group-key": "noise_sensors"
                           },
                           has_direct_power: {
                             description: "Indicates whether the device has direct power.",
-                            type: "boolean"
+                            type: "boolean",
+                            "x-property-group-key": "hardware"
                           },
                           image_alt_text: {
                             description: "Alt text for the device image.",
-                            type: "string"
+                            type: "string",
+                            "x-property-group-key": "hardware"
                           },
                           image_url: {
                             description: "Image URL for the device.",
                             format: "uri",
-                            type: "string"
+                            type: "string",
+                            "x-property-group-key": "hardware"
                           },
                           manufacturer: {
                             description: "Manufacturer of the device. When a device, such as a smart lock, is connected through a smart hub, the manufacturer of the device might be different from that of the smart hub.",
-                            type: "string"
+                            type: "string",
+                            "x-property-group-key": "hardware"
                           },
                           model: {
+                            description: "Device model-related properties.",
                             properties: {
                               accessory_keypad_supported: {
                                 deprecated: true,
@@ -12152,28 +12702,30 @@ var openapi_default = {
                                 "x-deprecated": "use device.properties.model.can_connect_accessory_keypad"
                               },
                               can_connect_accessory_keypad: {
-                                description: "Indicates whether the device can connect a accessory keypad.",
+                                description: "\n          Indicates whether the device can connect a accessory keypad.\n      ",
                                 type: "boolean"
                               },
                               display_name: {
-                                description: "Display name of the device model.",
+                                description: "\n          Display name of the device model.\n      ",
                                 type: "string"
                               },
                               has_built_in_keypad: {
-                                description: "Indicates whether the device has a built in accessory keypad.",
+                                description: "\n          Indicates whether the device has a built in accessory keypad.\n      ",
                                 type: "boolean"
                               },
                               manufacturer_display_name: {
-                                description: "Display name that corresponds to the manufacturer-specific terminology for the device.",
+                                description: "\n          Display name that corresponds to the manufacturer-specific terminology for the device.\n      ",
                                 type: "string"
                               },
                               offline_access_codes_supported: {
-                                description: "Indicates whether the device supports offline access codes.",
-                                type: "boolean"
+                                deprecated: true,
+                                type: "boolean",
+                                "x-deprecated": "use device.can_program_offline_access_codes."
                               },
                               online_access_codes_supported: {
-                                description: "Indicates whether the device supports online access codes.",
-                                type: "boolean"
+                                deprecated: true,
+                                type: "boolean",
+                                "x-deprecated": "use device.can_program_online_access_codes."
                               }
                             },
                             required: [
@@ -12191,11 +12743,13 @@ var openapi_default = {
                           noise_level_decibels: {
                             description: "Indicates current noise level in decibels, if the device supports noise detection.",
                             format: "float",
-                            type: "number"
+                            type: "number",
+                            "x-property-group-key": "noise_sensors"
                           },
                           offline_access_codes_enabled: {
                             description: "Indicates whether it is currently possible to use offline access codes for the device.",
-                            type: "boolean"
+                            type: "boolean",
+                            "x-property-group-key": "access_codes"
                           },
                           online: {
                             description: "Indicates whether the device is online.",
@@ -12203,28 +12757,32 @@ var openapi_default = {
                           },
                           online_access_codes_enabled: {
                             description: "Indicates whether it is currently possible to use online access codes for the device.",
-                            type: "boolean"
+                            type: "boolean",
+                            "x-property-group-key": "access_codes"
                           },
                           serial_number: {
                             description: "Serial number of the device.",
-                            type: "string"
+                            type: "string",
+                            "x-property-group-key": "hardware"
                           },
                           supports_accessory_keypad: {
                             deprecated: true,
                             type: "boolean",
-                            "x-deprecated": "use device.properties.model.can_connect_accessory_keypad"
+                            "x-deprecated": "use device.properties.model.can_connect_accessory_keypad",
+                            "x-property-group-key": "access_codes"
                           },
                           supports_offline_access_codes: {
                             deprecated: true,
                             type: "boolean",
-                            "x-deprecated": "use offline_access_codes_enabled"
+                            "x-deprecated": "use offline_access_codes_enabled",
+                            "x-property-group-key": "access_codes"
                           }
                         },
                         required: ["online", "name", "appearance", "model"],
                         type: "object"
                       },
                       {
-                        description: "Properties of the phone.",
+                        description: "\n          Properties of the phone.\n          ",
                         properties: {
                           assa_abloy_credential_service_metadata: {
                             description: "ASSA ABLOY Credential Service metadata for the phone.",
@@ -12272,31 +12830,73 @@ var openapi_default = {
                     ]
                   },
                   {
+                    description: "Provider-specific metadata.",
                     properties: {
                       akiles_metadata: {
+                        description: "Metadata for an Akiles device.\n          ",
                         properties: {
-                          _member_group_id: { type: "string" },
-                          gadget_id: { type: "string" },
-                          gadget_name: { type: "string" },
-                          product_name: { type: "string" }
+                          _member_group_id: {
+                            description: "Group ID to which to add users for an Akiles device.\n          ",
+                            type: "string"
+                          },
+                          gadget_id: {
+                            description: "Gadget ID for an Akiles device.\n          ",
+                            type: "string"
+                          },
+                          gadget_name: {
+                            description: "Gadget name for an Akiles device.\n          ",
+                            type: "string"
+                          },
+                          product_name: {
+                            description: "Product name for an Akiles device.\n          ",
+                            type: "string"
+                          }
                         },
                         required: ["gadget_name", "gadget_id", "product_name"],
                         type: "object"
                       },
                       assa_abloy_vostio_metadata: {
-                        properties: { encoder_name: { type: "string" } },
+                        description: "Metadata for an ASSA ABLOY Vostio system.\n          ",
+                        properties: {
+                          encoder_name: {
+                            description: "Encoder name for an ASSA ABLOY Vostio system.\n          ",
+                            type: "string"
+                          }
+                        },
                         required: ["encoder_name"],
                         type: "object"
                       },
                       august_metadata: {
+                        description: "Metadata for an August device.\n          ",
                         properties: {
-                          has_keypad: { type: "boolean" },
-                          house_id: { type: "string" },
-                          house_name: { type: "string" },
-                          keypad_battery_level: { type: "string" },
-                          lock_id: { type: "string" },
-                          lock_name: { type: "string" },
-                          model: { type: "string" }
+                          has_keypad: {
+                            description: "Indicates whether an August device has a keypad.\n          ",
+                            type: "boolean"
+                          },
+                          house_id: {
+                            description: "House ID for an August device.\n          ",
+                            type: "string"
+                          },
+                          house_name: {
+                            description: "House name for an August device.\n          ",
+                            type: "string"
+                          },
+                          keypad_battery_level: {
+                            description: "Keypad battery level for an August device.\n          ",
+                            type: "string"
+                          },
+                          lock_id: {
+                            description: "Lock ID for an August device.\n          ",
+                            type: "string"
+                          },
+                          lock_name: {
+                            description: "Lock name for an August device.\n          ",
+                            type: "string"
+                          },
+                          model: {
+                            description: "Model for an August device.\n          ",
+                            type: "string"
+                          }
                         },
                         required: [
                           "lock_id",
@@ -12307,17 +12907,39 @@ var openapi_default = {
                         type: "object"
                       },
                       avigilon_alta_metadata: {
+                        description: "Metadata for an Avigilon Alta system.\n          ",
                         properties: {
-                          entry_name: { type: "string" },
+                          entry_name: {
+                            description: "Entry name for an Avigilon Alta system.\n          ",
+                            type: "string"
+                          },
                           entry_relays_total_count: {
+                            description: "Total count of entry relays for an Avigilon Alta system.\n          ",
+                            format: "float",
+                            type: "number"
+                          },
+                          org_name: {
+                            description: "Organization name for an Avigilon Alta system.\n          ",
+                            type: "string"
+                          },
+                          site_id: {
+                            description: "Site ID for an Avigilon Alta system.\n          ",
                             format: "float",
                             type: "number"
                           },
-                          org_name: { type: "string" },
-                          site_id: { format: "float", type: "number" },
-                          site_name: { type: "string" },
-                          zone_id: { format: "float", type: "number" },
-                          zone_name: { type: "string" }
+                          site_name: {
+                            description: "Site name for an Avigilon Alta system.\n          ",
+                            type: "string"
+                          },
+                          zone_id: {
+                            description: "Zone ID for an Avigilon Alta system.\n          ",
+                            format: "float",
+                            type: "number"
+                          },
+                          zone_name: {
+                            description: "Zone name for an Avigilon Alta system.\n          ",
+                            type: "string"
+                          }
                         },
                         required: [
                           "entry_name",
@@ -12331,50 +12953,111 @@ var openapi_default = {
                         type: "object"
                       },
                       brivo_metadata: {
-                        properties: { device_name: { type: "string" } },
+                        description: "Metadata for a Brivo device.\n          ",
+                        properties: {
+                          device_name: {
+                            description: "Device name for a Brivo device.\n          ",
+                            type: "string"
+                          }
+                        },
                         required: ["device_name"],
                         type: "object"
                       },
                       controlbyweb_metadata: {
+                        description: "Metadata for a ControlByWeb device.\n          ",
                         properties: {
-                          device_id: { type: "string" },
-                          device_name: { type: "string" },
-                          relay_name: { nullable: true, type: "string" }
+                          device_id: {
+                            description: "Device ID for a ControlByWeb device.\n          ",
+                            type: "string"
+                          },
+                          device_name: {
+                            description: "Device name for a ControlByWeb device.\n          ",
+                            type: "string"
+                          },
+                          relay_name: {
+                            description: "Relay name for a ControlByWeb device.\n          ",
+                            nullable: true,
+                            type: "string"
+                          }
                         },
                         required: ["device_id", "device_name", "relay_name"],
                         type: "object"
                       },
                       dormakaba_oracode_metadata: {
+                        description: "Metadata for a dormakaba Oracode device.\n          ",
                         properties: {
                           device_id: {
+                            description: "Device ID for a dormakaba Oracode device.\n          ",
                             oneOf: [
                               { format: "float", type: "number" },
                               { type: "string" }
                             ]
                           },
-                          door_id: { format: "float", type: "number" },
-                          door_is_wireless: { type: "boolean" },
-                          door_name: { type: "string" },
-                          iana_timezone: { type: "string" },
+                          door_id: {
+                            description: "Door ID for a dormakaba Oracode device.\n          ",
+                            format: "float",
+                            type: "number"
+                          },
+                          door_is_wireless: {
+                            description: "Indicates whether a door is wireless for a dormakaba Oracode device.\n          ",
+                            type: "boolean"
+                          },
+                          door_name: {
+                            description: "Door name for a dormakaba Oracode device.\n          ",
+                            type: "string"
+                          },
+                          iana_timezone: {
+                            description: "IANA time zone for a dormakaba Oracode device.\n          ",
+                            type: "string"
+                          },
                           predefined_time_slots: {
+                            description: "Predefined time slots for a dormakaba Oracode device.\n          ",
                             items: {
+                              description: "Time slot for a dormakaba Oracode device.\n          ",
                               properties: {
-                                check_in_time: { type: "string" },
-                                check_out_time: { type: "string" },
+                                check_in_time: {
+                                  description: "Check in time for a time slot for a dormakaba Oracode device.\n          ",
+                                  type: "string"
+                                },
+                                check_out_time: {
+                                  description: "Checkout time for a time slot for a dormakaba Oracode device.\n          ",
+                                  type: "string"
+                                },
                                 dormakaba_oracode_user_level_id: {
+                                  description: "ID of a user level for a dormakaba Oracode device.\n          ",
                                   format: "uuid",
                                   type: "string"
                                 },
                                 ext_dormakaba_oracode_user_level_prefix: {
+                                  description: "Prefix for a user level for a dormakaba Oracode device.\n          ",
                                   format: "float",
                                   type: "number"
                                 },
-                                is_24_hour: { type: "boolean" },
-                                is_biweekly_mode: { type: "boolean" },
-                                is_master: { type: "boolean" },
-                                is_one_shot: { type: "boolean" },
-                                name: { type: "string" },
-                                prefix: { format: "float", type: "number" }
+                                is_24_hour: {
+                                  description: "Indicates whether a time slot for a dormakaba Oracode device is a 24-hour time slot.\n          ",
+                                  type: "boolean"
+                                },
+                                is_biweekly_mode: {
+                                  description: "Indicates whether a time slot for a dormakaba Oracode device is in biweekly mode.\n          ",
+                                  type: "boolean"
+                                },
+                                is_master: {
+                                  description: "Indicates whether a time slot for a dormakaba Oracode device is a master time slot.\n          ",
+                                  type: "boolean"
+                                },
+                                is_one_shot: {
+                                  description: "Indicates whether a time slot for a dormakaba Oracode device is a one-shot time slot.\n          ",
+                                  type: "boolean"
+                                },
+                                name: {
+                                  description: "Name of a time slot for a dormakaba Oracode device.\n          ",
+                                  type: "string"
+                                },
+                                prefix: {
+                                  description: "Prefix for a time slot for a dormakaba Oracode device.\n          ",
+                                  format: "float",
+                                  type: "number"
+                                }
                               },
                               required: [
                                 "name",
@@ -12393,12 +13076,17 @@ var openapi_default = {
                             type: "array"
                           },
                           site_id: {
-                            description: "@DEPRECATED",
+                            deprecated: true,
+                            description: "Site ID for a dormakaba Oracode device.",
                             format: "float",
                             nullable: true,
-                            type: "number"
+                            type: "number",
+                            "x-deprecated": 'Previously marked as "@DEPRECATED."'
                           },
-                          site_name: { type: "string" }
+                          site_name: {
+                            description: "Site name for a dormakaba Oracode device.\n          ",
+                            type: "string"
+                          }
                         },
                         required: [
                           "door_name",
@@ -12409,18 +13097,34 @@ var openapi_default = {
                         type: "object"
                       },
                       ecobee_metadata: {
+                        description: "Metadata for an ecobee device.\n          ",
                         properties: {
-                          device_name: { type: "string" },
-                          ecobee_device_id: { type: "string" }
+                          device_name: {
+                            description: "Device name for an ecobee device.\n          ",
+                            type: "string"
+                          },
+                          ecobee_device_id: {
+                            description: "Device ID for an ecobee device.\n          ",
+                            type: "string"
+                          }
                         },
                         required: ["ecobee_device_id", "device_name"],
                         type: "object"
                       },
                       four_suites_metadata: {
+                        description: "Metadata for a 4SUITES device.\n          ",
                         properties: {
-                          device_id: { format: "float", type: "number" },
-                          device_name: { type: "string" },
+                          device_id: {
+                            description: "Device ID for a 4SUITES device.\n          ",
+                            format: "float",
+                            type: "number"
+                          },
+                          device_name: {
+                            description: "Device name for a 4SUITES device.\n          ",
+                            type: "string"
+                          },
                           reclose_delay_in_seconds: {
+                            description: "Reclose delay, in seconds, for a 4SUITES device.\n          ",
                             format: "float",
                             type: "number"
                           }
@@ -12433,17 +13137,31 @@ var openapi_default = {
                         type: "object"
                       },
                       genie_metadata: {
+                        description: "Metadata for a Genie device.\n          ",
                         properties: {
-                          device_name: { type: "string" },
-                          door_name: { type: "string" }
+                          device_name: {
+                            description: "Lock name for a Genie device.\n          ",
+                            type: "string"
+                          },
+                          door_name: {
+                            description: "Door name for a Genie device.\n          ",
+                            type: "string"
+                          }
                         },
                         required: ["device_name", "door_name"],
                         type: "object"
                       },
                       honeywell_resideo_metadata: {
+                        description: "Metadata for a Honeywell Resideo device.\n          ",
                         properties: {
-                          device_name: { type: "string" },
-                          honeywell_resideo_device_id: { type: "string" }
+                          device_name: {
+                            description: "Device name for a Honeywell Resideo device.\n          ",
+                            type: "string"
+                          },
+                          honeywell_resideo_device_id: {
+                            description: "Device ID for a Honeywell Resideo device.\n          ",
+                            type: "string"
+                          }
                         },
                         required: [
                           "honeywell_resideo_device_id",
@@ -12452,94 +13170,198 @@ var openapi_default = {
                         type: "object"
                       },
                       hubitat_metadata: {
+                        description: "Metadata for a Hubitat device.\n          ",
                         properties: {
-                          device_id: { type: "string" },
-                          device_label: { type: "string" },
-                          device_name: { type: "string" }
+                          device_id: {
+                            description: "Device ID for a Hubitat device.\n          ",
+                            type: "string"
+                          },
+                          device_label: {
+                            description: "Device label for a Hubitat device.\n          ",
+                            type: "string"
+                          },
+                          device_name: {
+                            description: "Device name for a Hubitat device.\n          ",
+                            type: "string"
+                          }
                         },
                         required: ["device_id", "device_name", "device_label"],
                         type: "object"
                       },
                       igloo_metadata: {
+                        description: "Metadata for an igloo device.\n          ",
                         properties: {
-                          bridge_id: { type: "string" },
-                          device_id: { type: "string" },
-                          model: { type: "string" }
+                          bridge_id: {
+                            description: "Bridge ID for an igloo device.\n          ",
+                            type: "string"
+                          },
+                          device_id: {
+                            description: "Device ID for an igloo device.\n          ",
+                            type: "string"
+                          },
+                          model: {
+                            description: "Model for an igloo device.\n          ",
+                            type: "string"
+                          }
                         },
                         required: ["device_id", "bridge_id"],
                         type: "object"
                       },
                       igloohome_metadata: {
+                        description: "Metadata for an igloohome device.\n          ",
                         properties: {
-                          bridge_id: { type: "string" },
-                          bridge_name: { type: "string" },
-                          device_id: { type: "string" },
-                          device_name: { type: "string" },
-                          keypad_id: { type: "string" }
+                          bridge_id: {
+                            description: "Bridge ID for an igloohome device.\n          ",
+                            type: "string"
+                          },
+                          bridge_name: {
+                            description: "Bridge name for an igloohome device.\n          ",
+                            type: "string"
+                          },
+                          device_id: {
+                            description: "Device ID for an igloohome device.\n          ",
+                            type: "string"
+                          },
+                          device_name: {
+                            description: "Device name for an igloohome device.\n          ",
+                            type: "string"
+                          },
+                          keypad_id: {
+                            description: "Keypad ID for an igloohome device.\n          ",
+                            type: "string"
+                          }
                         },
                         required: ["device_id", "device_name"],
                         type: "object"
                       },
                       kwikset_metadata: {
+                        description: "Metadata for a Kwikset device.\n          ",
                         properties: {
-                          device_id: { type: "string" },
-                          device_name: { type: "string" },
-                          model_number: { type: "string" }
+                          device_id: {
+                            description: "Device ID for a Kwikset device.\n          ",
+                            type: "string"
+                          },
+                          device_name: {
+                            description: "Device name for a Kwikset device.\n          ",
+                            type: "string"
+                          },
+                          model_number: {
+                            description: "Model number for a Kwikset device.\n          ",
+                            type: "string"
+                          }
                         },
                         required: ["device_id", "device_name", "model_number"],
                         type: "object"
                       },
                       lockly_metadata: {
+                        description: "Metadata for a Lockly device.\n          ",
                         properties: {
-                          device_id: { type: "string" },
-                          device_name: { type: "string" },
-                          model: { type: "string" }
+                          device_id: {
+                            description: "Device ID for a Lockly device.\n          ",
+                            type: "string"
+                          },
+                          device_name: {
+                            description: "Device name for a Lockly device.\n          ",
+                            type: "string"
+                          },
+                          model: {
+                            description: "Model for a Lockly device.\n          ",
+                            type: "string"
+                          }
                         },
                         required: ["device_id", "device_name"],
                         type: "object"
                       },
                       minut_metadata: {
+                        description: "Metadata for a Minut device.\n          ",
                         properties: {
-                          device_id: { type: "string" },
-                          device_name: { type: "string" },
+                          device_id: {
+                            description: "Device ID for a Minut device.\n          ",
+                            type: "string"
+                          },
+                          device_name: {
+                            description: "Device name for a Minut device.\n          ",
+                            type: "string"
+                          },
                           latest_sensor_values: {
+                            description: "Latest sensor values for a Minut device.\n          ",
                             properties: {
                               accelerometer_z: {
+                                description: "Latest accelerometer Z-axis reading for a Minut device.\n          ",
                                 properties: {
-                                  time: { type: "string" },
-                                  value: { format: "float", type: "number" }
+                                  time: {
+                                    description: "Time of latest accelerometer Z-axis reading for a Minut device.\n          ",
+                                    type: "string"
+                                  },
+                                  value: {
+                                    description: "Value of latest accelerometer Z-axis reading for a Minut device.\n          ",
+                                    format: "float",
+                                    type: "number"
+                                  }
                                 },
                                 required: ["time", "value"],
                                 type: "object"
                               },
                               humidity: {
+                                description: "Latest humidity reading for a Minut device.\n          ",
                                 properties: {
-                                  time: { type: "string" },
-                                  value: { format: "float", type: "number" }
+                                  time: {
+                                    description: "Time of latest humidity reading for a Minut device.\n          ",
+                                    type: "string"
+                                  },
+                                  value: {
+                                    description: "Value of latest humidity reading for a Minut device.\n          ",
+                                    format: "float",
+                                    type: "number"
+                                  }
                                 },
                                 required: ["time", "value"],
                                 type: "object"
                               },
                               pressure: {
+                                description: "Latest pressure reading for a Minut device.\n          ",
                                 properties: {
-                                  time: { type: "string" },
-                                  value: { format: "float", type: "number" }
+                                  time: {
+                                    description: "Time of latest pressure reading for a Minut device.\n          ",
+                                    type: "string"
+                                  },
+                                  value: {
+                                    description: "Value of latest pressure reading for a Minut device.\n          ",
+                                    format: "float",
+                                    type: "number"
+                                  }
                                 },
                                 required: ["time", "value"],
                                 type: "object"
                               },
                               sound: {
+                                description: "Latest sound reading for a Minut device.\n          ",
                                 properties: {
-                                  time: { type: "string" },
-                                  value: { format: "float", type: "number" }
+                                  time: {
+                                    description: "Time of latest sound reading for a Minut device.\n          ",
+                                    type: "string"
+                                  },
+                                  value: {
+                                    description: "Value of latest sound reading for a Minut device.\n          ",
+                                    format: "float",
+                                    type: "number"
+                                  }
                                 },
                                 required: ["time", "value"],
                                 type: "object"
                               },
                               temperature: {
+                                description: "Latest temperature reading for a Minut device.\n          ",
                                 properties: {
-                                  time: { type: "string" },
-                                  value: { format: "float", type: "number" }
+                                  time: {
+                                    description: "Time of latest temperature reading for a Minut device.\n          ",
+                                    type: "string"
+                                  },
+                                  value: {
+                                    description: "Value of latest temperature reading for a Minut device.\n          ",
+                                    format: "float",
+                                    type: "number"
+                                  }
                                 },
                                 required: ["time", "value"],
                                 type: "object"
@@ -12563,11 +13385,24 @@ var openapi_default = {
                         type: "object"
                       },
                       nest_metadata: {
+                        description: "Metadata for a Google Nest device.\n          ",
                         properties: {
-                          device_custom_name: { type: "string" },
-                          device_name: { type: "string" },
-                          display_name: { type: "string" },
-                          nest_device_id: { type: "string" }
+                          device_custom_name: {
+                            description: "Custom device name for a Google Nest device. The device owner sets this value.\n          ",
+                            type: "string"
+                          },
+                          device_name: {
+                            description: "Device name for a Google Nest device. Google sets this value.\n          ",
+                            type: "string"
+                          },
+                          display_name: {
+                            description: "Display name for a Google Nest device.\n          ",
+                            type: "string"
+                          },
+                          nest_device_id: {
+                            description: "Device ID for a Google Nest device.\n          ",
+                            type: "string"
+                          }
                         },
                         required: [
                           "nest_device_id",
@@ -12577,18 +13412,31 @@ var openapi_default = {
                         type: "object"
                       },
                       noiseaware_metadata: {
+                        description: "Metadata for a NoiseAware device.\n          ",
                         properties: {
-                          device_id: { type: "string" },
+                          device_id: {
+                            description: "Device ID for a NoiseAware device.\n          ",
+                            type: "string"
+                          },
                           device_model: {
+                            description: "Device model for a NoiseAware device.\n          ",
                             enum: ["indoor", "outdoor"],
                             type: "string"
                           },
-                          device_name: { type: "string" },
+                          device_name: {
+                            description: "Device name for a NoiseAware device.\n          ",
+                            type: "string"
+                          },
                           noise_level_decibel: {
+                            description: "Noise level, in decibels, for a NoiseAware device.\n          ",
                             format: "float",
                             type: "number"
                           },
-                          noise_level_nrs: { format: "float", type: "number" }
+                          noise_level_nrs: {
+                            description: "Noise level, expressed as a Noise Risk Score (NRS), for a NoiseAware device.\n          ",
+                            format: "float",
+                            type: "number"
+                          }
                         },
                         required: [
                           "device_model",
@@ -12600,24 +13448,59 @@ var openapi_default = {
                         type: "object"
                       },
                       nuki_metadata: {
+                        description: "Metadata for a Nuki device.\n          ",
                         properties: {
-                          device_id: { type: "string" },
-                          device_name: { type: "string" },
-                          keypad_2_paired: { type: "boolean" },
-                          keypad_battery_critical: { type: "boolean" },
-                          keypad_paired: { type: "boolean" }
+                          device_id: {
+                            description: "Device ID for a Nuki device.\n          ",
+                            type: "string"
+                          },
+                          device_name: {
+                            description: "Device name for a Nuki device.\n          ",
+                            type: "string"
+                          },
+                          keypad_2_paired: {
+                            description: "Indicates whether keypad 2 is paired for a Nuki device.\n          ",
+                            type: "boolean"
+                          },
+                          keypad_battery_critical: {
+                            description: "Indicates whether the keypad battery is in a critical state for a Nuki device.\n          ",
+                            type: "boolean"
+                          },
+                          keypad_paired: {
+                            description: "Indicates whether the keypad is paired for a Nuki device.\n          ",
+                            type: "boolean"
+                          }
                         },
                         required: ["device_id", "device_name"],
                         type: "object"
                       },
                       salto_ks_metadata: {
+                        description: "Metadata for a Salto KS device.\n          ",
                         properties: {
-                          battery_level: { type: "string" },
-                          customer_reference: { type: "string" },
-                          lock_id: { type: "string" },
-                          lock_type: { type: "string" },
-                          locked_state: { type: "string" },
-                          model: { type: "string" }
+                          battery_level: {
+                            description: "Battery level for a Salto KS device.\n          ",
+                            type: "string"
+                          },
+                          customer_reference: {
+                            description: "Customer reference for a Salto KS device.\n          ",
+                            type: "string"
+                          },
+                          lock_id: {
+                            description: "Lock ID for a Salto KS device.\n          ",
+                            type: "string"
+                          },
+                          lock_type: {
+                            description: "Lock type for a Salto KS device.\n          ",
+                            type: "string"
+                          },
+                          locked_state: {
+                            description: "Locked state for a Salto KS device.\n          ",
+                            type: "string"
+                          },
+                          model: {
+                            description: "Model for a Salto KS device.\n          ",
+                            type: "string"
+                          }
                         },
                         required: [
                           "lock_id",
@@ -12629,14 +13512,33 @@ var openapi_default = {
                         type: "object"
                       },
                       salto_metadata: {
-                        description: "\n    ---\n    deprecated: Use `salto_ks_metadata ` instead.\n    ",
+                        deprecated: true,
+                        description: "Metada for a Salto device.",
                         properties: {
-                          battery_level: { type: "string" },
-                          customer_reference: { type: "string" },
-                          lock_id: { type: "string" },
-                          lock_type: { type: "string" },
-                          locked_state: { type: "string" },
-                          model: { type: "string" }
+                          battery_level: {
+                            description: "Battery level for a Salto device.\n          ",
+                            type: "string"
+                          },
+                          customer_reference: {
+                            description: "Customer reference for a Salto device.\n          ",
+                            type: "string"
+                          },
+                          lock_id: {
+                            description: "Lock ID for a Salto device.\n          ",
+                            type: "string"
+                          },
+                          lock_type: {
+                            description: "Lock type for a Salto device.\n          ",
+                            type: "string"
+                          },
+                          locked_state: {
+                            description: "Locked state for a Salto device.\n          ",
+                            type: "string"
+                          },
+                          model: {
+                            description: "Model for a Salto device.\n          ",
+                            type: "string"
+                          }
                         },
                         required: [
                           "lock_id",
@@ -12645,22 +13547,42 @@ var openapi_default = {
                           "battery_level",
                           "locked_state"
                         ],
-                        type: "object"
+                        type: "object",
+                        "x-deprecated": "Use `salto_ks_metadata ` instead."
                       },
                       schlage_metadata: {
+                        description: "Metadata for a Schlage device.\n          ",
                         properties: {
-                          device_id: { type: "string" },
-                          device_name: { type: "string" },
-                          model: { type: "string" }
+                          device_id: {
+                            description: "Device ID for a Schlage device.\n          ",
+                            type: "string"
+                          },
+                          device_name: {
+                            description: "Device name for a Schlage device.\n          ",
+                            type: "string"
+                          },
+                          model: {
+                            description: "Model for a Schlage device.\n          ",
+                            type: "string"
+                          }
                         },
                         required: ["device_id", "device_name"],
                         type: "object"
                       },
                       seam_bridge_metadata: {
+                        description: "Metadata for Seam Bridge.\n          ",
                         properties: {
-                          device_num: { format: "float", type: "number" },
-                          name: { type: "string" },
+                          device_num: {
+                            description: "Device number for Seam Bridge.\n          ",
+                            format: "float",
+                            type: "number"
+                          },
+                          name: {
+                            description: "Name for Seam Bridge.\n          ",
+                            type: "string"
+                          },
                           unlock_method: {
+                            description: "Unlock method for Seam Bridge.\n          ",
                             enum: ["bridge", "doorking"],
                             type: "string"
                           }
@@ -12669,41 +13591,96 @@ var openapi_default = {
                         type: "object"
                       },
                       sensi_metadata: {
+                        description: "Metadata for a Sensi device.\n          ",
                         properties: {
-                          device_id: { type: "string" },
-                          device_name: { type: "string" },
-                          product_type: { type: "string" }
+                          device_id: {
+                            description: "Device ID for a Sensi device.\n          ",
+                            type: "string"
+                          },
+                          device_name: {
+                            description: "Device name for a Sensi device.\n          ",
+                            type: "string"
+                          },
+                          product_type: {
+                            description: "Product type for a Sensi device.\n          ",
+                            type: "string"
+                          }
                         },
                         required: ["device_id", "device_name", "product_type"],
                         type: "object"
                       },
                       smartthings_metadata: {
+                        description: "Metadata for a SmartThings device.\n          ",
                         properties: {
-                          device_id: { type: "string" },
-                          device_name: { type: "string" },
-                          location_id: { type: "string" },
-                          model: { type: "string" }
+                          device_id: {
+                            description: "Device ID for a SmartThings device.\n          ",
+                            type: "string"
+                          },
+                          device_name: {
+                            description: "Device name for a SmartThings device.\n          ",
+                            type: "string"
+                          },
+                          location_id: {
+                            description: "Location ID for a SmartThings device.\n          ",
+                            type: "string"
+                          },
+                          model: {
+                            description: "Model for a SmartThings device.\n          ",
+                            type: "string"
+                          }
                         },
                         required: ["device_id", "device_name"],
                         type: "object"
                       },
                       tado_metadata: {
+                        description: "Metadata for a tado\xB0 device.\n          ",
                         properties: {
-                          device_type: { type: "string" },
-                          serial_no: { type: "string" }
+                          device_type: {
+                            description: "Device type for a tado\xB0 device.\n          ",
+                            type: "string"
+                          },
+                          serial_no: {
+                            description: "Serial number for a tado\xB0 device.\n          ",
+                            type: "string"
+                          }
                         },
                         required: ["serial_no", "device_type"],
                         type: "object"
                       },
                       tedee_metadata: {
+                        description: "Metadata for a Tedee device.\n          ",
                         properties: {
-                          bridge_id: { format: "float", type: "number" },
-                          bridge_name: { type: "string" },
-                          device_id: { format: "float", type: "number" },
-                          device_model: { type: "string" },
-                          device_name: { type: "string" },
-                          keypad_id: { format: "float", type: "number" },
-                          serial_number: { type: "string" }
+                          bridge_id: {
+                            description: "Bridge ID for a Tedee device.\n          ",
+                            format: "float",
+                            type: "number"
+                          },
+                          bridge_name: {
+                            description: "Bridge name for a Tedee device.\n          ",
+                            type: "string"
+                          },
+                          device_id: {
+                            description: "Device ID for a Tedee device.\n          ",
+                            format: "float",
+                            type: "number"
+                          },
+                          device_model: {
+                            description: "Device model for a Tedee device.\n          ",
+                            type: "string"
+                          },
+                          device_name: {
+                            description: "Device name for a Tedee device.\n          ",
+                            type: "string"
+                          },
+                          keypad_id: {
+                            description: "Keypad ID for a Tedee device.\n          ",
+                            format: "float",
+                            type: "number"
+                          },
+                          serial_number: {
+                            description: "Serial number for a Tedee device.\n          ",
+                            type: "string"
+                          }
                         },
                         required: [
                           "device_id",
@@ -12716,16 +13693,39 @@ var openapi_default = {
                         type: "object"
                       },
                       ttlock_metadata: {
+                        description: "Metadata for a TTLock device.\n          ",
                         properties: {
-                          feature_value: { type: "string" },
+                          feature_value: {
+                            description: "Feature value for a TTLock device.\n          ",
+                            type: "string"
+                          },
                           features: {
+                            description: "Features for a TTLock device.\n          ",
                             properties: {
-                              incomplete_keyboard_passcode: { type: "boolean" },
-                              lock_command: { type: "boolean" },
-                              passcode: { type: "boolean" },
-                              passcode_management: { type: "boolean" },
-                              unlock_via_gateway: { type: "boolean" },
-                              wifi: { type: "boolean" }
+                              incomplete_keyboard_passcode: {
+                                description: "Indicates whether a TTLock device supports an incomplete keyboard passcode.\n          ",
+                                type: "boolean"
+                              },
+                              lock_command: {
+                                description: "Indicates whether a TTLock device supports the lock command.\n          ",
+                                type: "boolean"
+                              },
+                              passcode: {
+                                description: "Indicates whether a TTLock device supports a passcode.\n          ",
+                                type: "boolean"
+                              },
+                              passcode_management: {
+                                description: "Indicates whether a TTLock device supports passcode management.\n          ",
+                                type: "boolean"
+                              },
+                              unlock_via_gateway: {
+                                description: "Indicates whether a TTLock device supports unlock via gateway.\n          ",
+                                type: "boolean"
+                              },
+                              wifi: {
+                                description: "Indicates whether a TTLock device supports Wi-Fi.\n          ",
+                                type: "boolean"
+                              }
                             },
                             required: [
                               "passcode",
@@ -12737,17 +13737,32 @@ var openapi_default = {
                             ],
                             type: "object"
                           },
-                          has_gateway: { type: "boolean" },
-                          lock_alias: { type: "string" },
-                          lock_id: { format: "float", type: "number" },
+                          has_gateway: {
+                            description: "Indicates whether a TTLock device has a gateway.\n          ",
+                            type: "boolean"
+                          },
+                          lock_alias: {
+                            description: "Lock alias for a TTLock device.\n          ",
+                            type: "string"
+                          },
+                          lock_id: {
+                            description: "Lock ID for a TTLock device.\n          ",
+                            format: "float",
+                            type: "number"
+                          },
                           wireless_keypads: {
+                            description: "Wireless keypads for a TTLock device.\n          ",
                             items: {
                               properties: {
                                 wireless_keypad_id: {
+                                  description: "ID for a wireless keypad for a TTLock device.\n          ",
                                   format: "float",
                                   type: "number"
                                 },
-                                wireless_keypad_name: { type: "string" }
+                                wireless_keypad_name: {
+                                  description: "Name for a wireless keypad for a TTLock device.\n          ",
+                                  type: "string"
+                                }
                               },
                               required: [
                                 "wireless_keypad_id",
@@ -12767,31 +13782,68 @@ var openapi_default = {
                         type: "object"
                       },
                       two_n_metadata: {
+                        description: "Metadata for a 2N device.\n          ",
                         properties: {
-                          device_id: { format: "float", type: "number" },
-                          device_name: { type: "string" }
+                          device_id: {
+                            description: "Device ID for a 2N device.\n          ",
+                            format: "float",
+                            type: "number"
+                          },
+                          device_name: {
+                            description: "Device name for a 2N device.\n          ",
+                            type: "string"
+                          }
                         },
                         required: ["device_id", "device_name"],
                         type: "object"
                       },
                       visionline_metadata: {
-                        properties: { encoder_id: { type: "string" } },
+                        description: "Metadata for an ASSA ABLOY Visionline system.\n          ",
+                        properties: {
+                          encoder_id: {
+                            description: "Encoder ID for an ASSA ABLOY Visionline system.\n          ",
+                            type: "string"
+                          }
+                        },
                         required: ["encoder_id"],
                         type: "object"
                       },
                       wyze_metadata: {
+                        description: "Metadata for a Wyze device.\n          ",
                         properties: {
-                          device_id: { type: "string" },
-                          device_info_model: { type: "string" },
-                          device_name: { type: "string" },
-                          keypad_uuid: { type: "string" },
+                          device_id: {
+                            description: "Device ID for a Wyze device.\n          ",
+                            type: "string"
+                          },
+                          device_info_model: {
+                            description: "Device information model for a Wyze device.\n          ",
+                            type: "string"
+                          },
+                          device_name: {
+                            description: "Device name for a Wyze device.\n          ",
+                            type: "string"
+                          },
+                          keypad_uuid: {
+                            description: "Keypad UUID for a Wyze device.\n          ",
+                            type: "string"
+                          },
                           locker_status_hardlock: {
+                            description: "Locker status (hardlock) for a Wyze device.\n          ",
                             format: "float",
                             type: "number"
                           },
-                          product_model: { type: "string" },
-                          product_name: { type: "string" },
-                          product_type: { type: "string" }
+                          product_model: {
+                            description: "Product model for a Wyze device.\n          ",
+                            type: "string"
+                          },
+                          product_name: {
+                            description: "Product name for a Wyze device.\n          ",
+                            type: "string"
+                          },
+                          product_type: {
+                            description: "Product type for a Wyze device.\n          ",
+                            type: "string"
+                          }
                         },
                         required: [
                           "device_id",
@@ -12804,7 +13856,8 @@ var openapi_default = {
                         type: "object"
                       }
                     },
-                    type: "object"
+                    type: "object",
+                    "x-property-group-key": "provider_metadata"
                   }
                 ]
               },
@@ -12814,15 +13867,19 @@ var openapi_default = {
                     properties: {
                       _experimental_supported_code_from_access_codes_lengths: {
                         items: { format: "float", type: "number" },
-                        type: "array"
+                        type: "array",
+                        "x-undocumented": "Marked as experimental."
                       },
                       code_constraints: {
                         description: "Constraints on access codes for the device. Seam represents each constraint as an object with a `constraint_type` property. Depending on the constraint type, there may also be additional properties. Note that some constraints are manufacturer- or device-specific.",
                         items: {
+                          description: "Access code constraint.",
                           oneOf: [
                             {
+                              description: "Code constraint for access codes.",
                               properties: {
                                 constraint_type: {
+                                  description: "Code constraint type for access codes.",
                                   enum: [
                                     "no_zeros",
                                     "cannot_start_with_12",
@@ -12842,40 +13899,76 @@ var openapi_default = {
                               type: "object"
                             },
                             {
+                              description: "Name constraint for access codes.",
                               properties: {
                                 constraint_type: {
                                   enum: ["name_length", "name_must_be_unique"],
                                   type: "string"
                                 },
-                                max_length: { format: "float", type: "number" },
-                                min_length: { format: "float", type: "number" }
+                                max_length: {
+                                  description: "Maximum name length constraint for access codes.",
+                                  format: "float",
+                                  type: "number"
+                                },
+                                min_length: {
+                                  description: "Minimum name length constraint for access codes.",
+                                  format: "float",
+                                  type: "number"
+                                }
                               },
                               required: ["constraint_type"],
                               type: "object"
                             }
                           ]
                         },
-                        type: "array"
+                        type: "array",
+                        "x-property-group-key": "access_codes"
+                      },
+                      door_open: {
+                        description: "Indicates whether the door is open.",
+                        type: "boolean",
+                        "x-property-group-key": "locks"
+                      },
+                      has_native_entry_events: {
+                        description: "Indicates whether the device supports native entry events.",
+                        type: "boolean",
+                        "x-property-group-key": "access_codes"
                       },
-                      door_open: { type: "boolean" },
-                      has_native_entry_events: { type: "boolean" },
                       keypad_battery: {
+                        description: "Keypad battery status.",
                         properties: {
-                          level: { format: "float", type: "number" }
+                          level: {
+                            description: "Keypad battery charge level.\n          ",
+                            format: "float",
+                            type: "number"
+                          }
                         },
                         required: ["level"],
-                        type: "object"
+                        type: "object",
+                        "x-property-group-key": "access_codes"
+                      },
+                      locked: {
+                        description: "Indicates whether the lock is locked.",
+                        type: "boolean",
+                        "x-property-group-key": "locks"
                       },
-                      locked: { type: "boolean" },
                       max_active_codes_supported: {
+                        description: "Maximum number of active access codes that the device supports.",
                         format: "float",
-                        type: "number"
+                        type: "number",
+                        "x-property-group-key": "access_codes"
                       },
                       supported_code_lengths: {
+                        description: "Supported code lengths for access codes.",
                         items: { format: "float", type: "number" },
-                        type: "array"
+                        type: "array",
+                        "x-property-group-key": "access_codes"
                       },
-                      supports_backup_access_code_pool: { type: "boolean" }
+                      supports_backup_access_code_pool: {
+                        description: "Indicates whether the device supports a [backup access code pool](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes/backup-access-codes).",
+                        type: "boolean",
+                        "x-property-group-key": "access_codes"
+                      }
                     },
                     type: "object"
                   },
@@ -12883,7 +13976,7 @@ var openapi_default = {
                     properties: {
                       active_thermostat_schedule: {
                         default: null,
-                        description: "Represents a [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules) that activates a configured [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) on a [thermostat](https://docs.seam.co/latest/capability-guides/thermostats) at a specified starting time and deactivates the climate preset at a specified ending time.",
+                        description: "Active [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules).",
                         nullable: true,
                         properties: {
                           climate_preset_key: {
@@ -12967,9 +14060,11 @@ var openapi_default = {
                           "errors"
                         ],
                         type: "object",
+                        "x-property-group-key": "thermostats",
                         "x-route-path": "/thermostats/schedules"
                       },
                       available_climate_presets: {
+                        description: "Available [climate presets](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) for the thermostat.",
                         items: {
                           properties: {
                             can_delete: {
@@ -13045,23 +14140,29 @@ var openapi_default = {
                           ],
                           type: "object"
                         },
-                        type: "array"
+                        type: "array",
+                        "x-property-group-key": "thermostats"
                       },
                       available_fan_mode_settings: {
+                        description: "Fan mode settings that the thermostat supports.",
                         items: {
                           enum: ["auto", "on", "circulate"],
                           type: "string"
                         },
-                        type: "array"
+                        type: "array",
+                        "x-property-group-key": "thermostats"
                       },
                       available_hvac_mode_settings: {
+                        description: "HVAC mode settings that the thermostat supports.",
                         items: {
                           enum: ["off", "heat", "cool", "heat_cool"],
                           type: "string"
                         },
-                        type: "array"
+                        type: "array",
+                        "x-property-group-key": "thermostats"
                       },
                       current_climate_setting: {
+                        description: "Current climate setting.",
                         properties: {
                           can_delete: {
                             description: "Indicates whether the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) key can be deleted.",
@@ -13126,7 +14227,8 @@ var openapi_default = {
                             type: "string"
                           }
                         },
-                        type: "object"
+                        type: "object",
+                        "x-property-group-key": "thermostats"
                       },
                       default_climate_setting: {
                         deprecated: true,
@@ -13195,93 +14297,147 @@ var openapi_default = {
                           }
                         },
                         type: "object",
-                        "x-deprecated": "use fallback_climate_preset_key to specify a fallback climate preset instead."
+                        "x-deprecated": "use fallback_climate_preset_key to specify a fallback climate preset instead.",
+                        "x-property-group-key": "thermostats"
                       },
                       fallback_climate_preset_key: {
                         default: null,
+                        description: "Key of the [fallback climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets/setting-the-fallback-climate-preset) for the thermostat.",
                         minLength: 1,
                         nullable: true,
-                        type: "string"
+                        type: "string",
+                        "x-property-group-key": "thermostats"
                       },
                       fan_mode_setting: {
                         deprecated: true,
                         enum: ["auto", "on", "circulate"],
                         type: "string",
-                        "x-deprecated": "use current_climate_setting.fan_mode_setting instead."
+                        "x-deprecated": "Use `current_climate_setting.fan_mode_setting` instead.",
+                        "x-property-group-key": "thermostats"
+                      },
+                      is_cooling: {
+                        description: "Indicates whether the connected HVAC system is currently cooling, as reported by the thermostat.",
+                        type: "boolean",
+                        "x-property-group-key": "thermostats"
+                      },
+                      is_fan_running: {
+                        description: "Indicates whether the fan in the connected HVAC system is currently running, as reported by the thermostat.",
+                        type: "boolean",
+                        "x-property-group-key": "thermostats"
+                      },
+                      is_heating: {
+                        description: "Indicates whether the connected HVAC system is currently heating, as reported by the thermostat.",
+                        type: "boolean",
+                        "x-property-group-key": "thermostats"
+                      },
+                      is_temporary_manual_override_active: {
+                        description: "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`.",
+                        type: "boolean",
+                        "x-property-group-key": "thermostats"
                       },
-                      is_cooling: { type: "boolean" },
-                      is_fan_running: { type: "boolean" },
-                      is_heating: { type: "boolean" },
-                      is_temporary_manual_override_active: { type: "boolean" },
                       max_cooling_set_point_celsius: {
+                        description: "Maximum [cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points#cooling-set-point) in \xB0C.",
                         format: "float",
-                        type: "number"
+                        type: "number",
+                        "x-property-group-key": "thermostats"
                       },
                       max_cooling_set_point_fahrenheit: {
+                        description: "Maximum [cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points#cooling-set-point) in \xB0F.",
                         format: "float",
-                        type: "number"
+                        type: "number",
+                        "x-property-group-key": "thermostats"
                       },
                       max_heating_set_point_celsius: {
+                        description: "Maximum [heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points#heating-set-point) in \xB0C.",
                         format: "float",
-                        type: "number"
+                        type: "number",
+                        "x-property-group-key": "thermostats"
                       },
                       max_heating_set_point_fahrenheit: {
+                        description: "Maximum [heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points#heating-set-point) in \xB0F.",
                         format: "float",
-                        type: "number"
+                        type: "number",
+                        "x-property-group-key": "thermostats"
                       },
                       min_cooling_set_point_celsius: {
+                        description: "Minimum [cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points#cooling-set-point) in \xB0C.",
                         format: "float",
-                        type: "number"
+                        type: "number",
+                        "x-property-group-key": "thermostats"
                       },
                       min_cooling_set_point_fahrenheit: {
+                        description: "Minimum [cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points#cooling-set-point) in \xB0F.",
                         format: "float",
-                        type: "number"
+                        type: "number",
+                        "x-property-group-key": "thermostats"
                       },
                       min_heating_cooling_delta_celsius: {
+                        description: "Minimum [temperature difference](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points#minimum-heating-cooling-temperature-delta) in \xB0C between the cooling and heating set points when in heat-cool (auto) mode.",
                         format: "float",
-                        type: "number"
+                        type: "number",
+                        "x-property-group-key": "thermostats"
                       },
                       min_heating_cooling_delta_fahrenheit: {
+                        description: "Minimum [temperature difference](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points#minimum-heating-cooling-temperature-delta) in \xB0F between the cooling and heating set points when in heat-cool (auto) mode.",
                         format: "float",
-                        type: "number"
+                        type: "number",
+                        "x-property-group-key": "thermostats"
                       },
                       min_heating_set_point_celsius: {
+                        description: "Minimum [heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points#heating-set-point) in \xB0C.",
                         format: "float",
-                        type: "number"
+                        type: "number",
+                        "x-property-group-key": "thermostats"
                       },
                       min_heating_set_point_fahrenheit: {
+                        description: "Minimum [heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points#heating-set-point) in \xB0F.",
                         format: "float",
-                        type: "number"
+                        type: "number",
+                        "x-property-group-key": "thermostats"
                       },
                       relative_humidity: {
+                        description: "Reported relative humidity, as a value between 0 and 1, inclusive.",
                         format: "float",
                         maximum: 1,
                         minimum: 0,
-                        type: "number"
+                        type: "number",
+                        "x-property-group-key": "thermostats"
+                      },
+                      temperature_celsius: {
+                        description: "Reported temperature in \xB0C.",
+                        format: "float",
+                        type: "number",
+                        "x-property-group-key": "thermostats"
                       },
-                      temperature_celsius: { format: "float", type: "number" },
                       temperature_fahrenheit: {
+                        description: "Reported temperature in \xB0F.",
                         format: "float",
-                        type: "number"
+                        type: "number",
+                        "x-property-group-key": "thermostats"
                       },
                       temperature_threshold: {
+                        description: "Current [temperature threshold](https://docs.seam.co/latest/capability-guides/thermostats/setting-and-monitoring-temperature-thresholds) set for the thermostat.",
                         properties: {
                           lower_limit_celsius: {
+                            description: "Lower limit in \xB0C within the current [temperature threshold](https://docs.seam.co/latest/capability-guides/thermostats/setting-and-monitoring-temperature-thresholds) set for the thermostat.\n          ",
                             format: "float",
                             nullable: true,
                             type: "number"
                           },
                           lower_limit_fahrenheit: {
+                            description: "Lower limit in \xB0F within the current [temperature threshold](https://docs.seam.co/latest/capability-guides/thermostats/setting-and-monitoring-temperature-thresholds) set for the thermostat.\n          ",
                             format: "float",
                             nullable: true,
                             type: "number"
                           },
                           upper_limit_celsius: {
+                            description: "Upper limit in \xB0C within the current [temperature threshold](https://docs.seam.co/latest/capability-guides/thermostats/setting-and-monitoring-temperature-thresholds) set for the thermostat.\n          ",
                             format: "float",
                             nullable: true,
                             type: "number"
                           },
                           upper_limit_fahrenheit: {
+                            description: "Upper limit in \xB0F within the current [temperature threshold](https://docs.seam.co/latest/capability-guides/thermostats/setting-and-monitoring-temperature-thresholds) set for the thermostat.\n          ",
                             format: "float",
                             nullable: true,
                             type: "number"
@@ -13293,9 +14449,11 @@ var openapi_default = {
                           "upper_limit_celsius",
                           "upper_limit_fahrenheit"
                         ],
-                        type: "object"
+                        type: "object",
+                        "x-property-group-key": "thermostats"
                       },
                       thermostat_daily_programs: {
+                        description: "Configured [daily programs](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-programs) for the thermostat.",
                         items: {
                           description: "Represents a thermostat daily program, consisting of a set of periods, each of which has a starting time and the key that identifies the climate preset to apply at the starting time.",
                           properties: {
@@ -13359,9 +14517,11 @@ var openapi_default = {
                           type: "object",
                           "x-route-path": "/thermostats/thermostat_daily_programs"
                         },
-                        type: "array"
+                        type: "array",
+                        "x-property-group-key": "thermostats"
                       },
                       thermostat_weekly_program: {
+                        description: "Current [weekly program](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-programs) for the thermostat.",
                         nullable: true,
                         properties: {
                           created_at: {
@@ -13422,7 +14582,8 @@ var openapi_default = {
                           "sunday_program_id",
                           "created_at"
                         ],
-                        type: "object"
+                        type: "object",
+                        "x-property-group-key": "thermostats"
                       }
                     },
                     type: "object"
@@ -13430,7 +14591,16 @@ var openapi_default = {
                 ]
               }
             ],
-            description: "Properties of the device."
+            description: "Properties of the device.",
+            "x-property-groups": {
+              access_codes: { name: "Access Codes" },
+              hardware: { name: "Hardware" },
+              locks: { name: "Locks" },
+              noise_sensors: { name: "Noise Sensors" },
+              phones: { name: "Phones" },
+              provider_metadata: { name: "Provider Metadata" },
+              thermostats: { name: "Thermostats" }
+            }
           },
           warnings: {
             description: '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.',
@@ -13701,6 +14871,15 @@ var openapi_default = {
           "custom_metadata"
         ],
         type: "object",
+        "x-property-groups": {
+          access_codes: { name: "Access Codes" },
+          hardware: { name: "Hardware" },
+          locks: { name: "Locks" },
+          noise_sensors: { name: "Noise Sensors" },
+          phones: { name: "Phones" },
+          provider_metadata: { name: "Provider Metadata" },
+          thermostats: { name: "Thermostats" }
+        },
         "x-route-path": "/devices"
       },
       device_provider: {
@@ -18552,7 +19731,7 @@ var openapi_default = {
         description: "Represents an app user's mobile phone.",
         properties: {
           created_at: {
-            description: "Date and time at which the `phone` was created.",
+            description: "Date and time at which the phone was created.\n  ",
             format: "date-time",
             type: "string"
           },
@@ -18560,25 +19739,25 @@ var openapi_default = {
             additionalProperties: {
               oneOf: [{ type: "string" }, { type: "boolean" }]
             },
-            description: "Optional [custom metadata](https://docs.seam.co/latest/core-concepts/devices/adding-custom-metadata-to-a-device) for the phone.",
+            description: "Optional [custom metadata](https://docs.seam.co/latest/core-concepts/devices/adding-custom-metadata-to-a-device) for the phone.\n  ",
             type: "object"
           },
           device_id: {
-            description: "ID of the `phone`.",
+            description: "ID of the phone.\n          ",
             format: "uuid",
             type: "string"
           },
           device_type: {
-            description: "Type of phone.",
+            description: "Device type for phones.\n          ",
             enum: ["ios_phone", "android_phone"],
             type: "string"
           },
           display_name: {
-            description: "Display name of the phone. Defaults to `nickname` (if it is set) or `properties.appearance.name` otherwise. Enables administrators and users to identify the phone easily, especially when there are numerous phones.",
+            description: "Display name of the phone. Defaults to `nickname` (if it is set) or `properties.appearance.name` otherwise. Enables administrators and users to identify the phone easily, especially when there are numerous phones.\n  ",
             type: "string"
           },
           errors: {
-            description: "Errors associated with the `phone`.",
+            description: "Errors associated with the phone.",
             items: {
               properties: {
                 error_code: { type: "string" },
@@ -18590,11 +19769,11 @@ var openapi_default = {
             type: "array"
           },
           nickname: {
-            description: "Optional nickname to describe the phone, settable through Seam.",
+            description: "Optional nickname to describe the phone, settable through Seam.\n  ",
             type: "string"
           },
           properties: {
-            description: "Properties of the phone.",
+            description: "\n          Properties of the phone.\n          ",
             properties: {
               assa_abloy_credential_service_metadata: {
                 description: "ASSA ABLOY Credential Service metadata for the phone.",
@@ -18640,7 +19819,7 @@ var openapi_default = {
             type: "object"
           },
           warnings: {
-            description: "Warnings associated with the `phone`.",
+            description: "Warnings associated with the phone.",
             items: {
               properties: {
                 message: { type: "string" },
@@ -18652,7 +19831,7 @@ var openapi_default = {
             type: "array"
           },
           workspace_id: {
-            description: "ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the `phone`.",
+            description: "ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the phone.\n  ",
             format: "uuid",
             type: "string"
           }
@@ -18669,6 +19848,7 @@ var openapi_default = {
           "properties"
         ],
         type: "object",
+        "x-property-groups": { phones: { name: "Phones" } },
         "x-route-path": "/phones"
       },
       phone_registration: {
@@ -21666,8 +22846,9 @@ var openapi_default = {
           can_simulate_removal: { type: "boolean" },
           can_turn_off_hvac: { type: "boolean" },
           capabilities_supported: {
-            description: '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; and "battery," which indicates that the device can manage battery life and health.',
+            description: "\n        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](https://docs.seam.co/latest/capability-guides/device-and-system-capabilities#capability-flags).\n        ",
             items: {
+              description: "\n        Collection of capabilities that the device supports when connected to Seam. **Important:** Superseded by [capability flags](https://docs.seam.co/latest/capability-guides/device-and-system-capabilities#capability-flags).\n        ",
               enum: [
                 "access_code",
                 "lock",
@@ -21699,6 +22880,7 @@ var openapi_default = {
             description: "Type of the device.",
             oneOf: [
               {
+                description: "Device type for smartlocks.\n          ",
                 enum: [
                   "akuvox_lock",
                   "august_lock",
@@ -21731,10 +22913,12 @@ var openapi_default = {
                 type: "string"
               },
               {
+                description: "Device type for noise sensors.\n          ",
                 enum: ["noiseaware_activity_zone", "minut_sensor"],
                 type: "string"
               },
               {
+                description: "Device type for thermostats.\n          ",
                 enum: [
                   "ecobee_thermostat",
                   "nest_thermostat",
@@ -21746,7 +22930,7 @@ var openapi_default = {
                 type: "string"
               },
               {
-                description: "Type of phone.",
+                description: "Device type for phones.\n          ",
                 enum: ["ios_phone", "android_phone"],
                 type: "string"
               }
@@ -22095,23 +23279,25 @@ var openapi_default = {
             nullable: true,
             properties: {
               location_name: {
-                description: "Name of the device location.",
+                description: "Name of the device location.\n          ",
                 type: "string"
               },
               timezone: {
-                description: "Time zone of the device location.",
+                description: "Time zone of the device location.\n          ",
                 type: "string"
               }
             },
-            type: "object"
+            type: "object",
+            "x-property-group-key": "hardware"
           },
           properties: {
+            description: "properties of the device.",
             properties: {
               accessory_keypad: {
-                description: "Represents the accessory keypad state.",
+                description: "Accessory keypad properties and state.",
                 properties: {
                   battery: {
-                    description: "Indicates if the keypad battery properties.",
+                    description: "Keypad battery properties.\n          ",
                     properties: {
                       level: {
                         format: "float",
@@ -22124,51 +23310,60 @@ var openapi_default = {
                     type: "object"
                   },
                   is_connected: {
-                    description: "Indicates if the accessory_keypad is connected to the device.",
+                    description: "Indicates if an accessory keypad is connected to the device.\n        ",
                     type: "boolean"
                   }
                 },
                 required: ["is_connected"],
-                type: "object"
+                type: "object",
+                "x-property-group-key": "hardware"
               },
               battery: {
-                description: 'Represents the current status of the battery charge level. Values are "critical," which indicates an extremely low level, suggesting imminent shutdown or an urgent need for charging; "low," which signifies that the battery is under the preferred threshold and should be charged soon; "good," which denotes a satisfactory charge level, adequate for normal use without the immediate need for recharging; and "full," which represents a battery that is fully charged, providing the maximum duration of usage.',
+                description: "Represents the current status of the battery charge level.",
                 properties: {
                   level: {
+                    description: "Battery charge level as a value between 0 and 1, inclusive.\n          ",
                     format: "float",
                     maximum: 1,
                     minimum: 0,
                     type: "number"
                   },
                   status: {
+                    description: "Represents the current status of the battery charge level. Values are `critical`, which indicates an extremely low level, suggesting imminent shutdown or an urgent need for charging; `low`, which signifies that the battery is under the preferred threshold and should be charged soon; `good`, which denotes a satisfactory charge level, adequate for normal use without the immediate need for recharging; and `full`, which represents a battery that is fully charged, providing the maximum duration of usage.\n          ",
                     enum: ["critical", "low", "good", "full"],
                     type: "string"
                   }
                 },
                 required: ["level", "status"],
-                type: "object"
+                type: "object",
+                "x-property-group-key": "hardware"
               },
               battery_level: {
                 description: "Indicates the battery level of the device as a decimal value between 0 and 1, inclusive.",
                 format: "float",
                 maximum: 1,
                 minimum: 0,
-                type: "number"
+                type: "number",
+                "x-property-group-key": "hardware"
               },
               image_alt_text: {
                 description: "Alt text for the device image.",
-                type: "string"
+                type: "string",
+                "x-property-group-key": "hardware"
               },
               image_url: {
                 description: "Image URL for the device.",
                 format: "uri",
-                type: "string"
+                type: "string",
+                "x-property-group-key": "hardware"
               },
               manufacturer: {
                 description: "Manufacturer of the device. When a device, such as a smart lock, is connected through a smart hub, the manufacturer of the device might be different from that of the smart hub.",
-                type: "string"
+                type: "string",
+                "x-property-group-key": "hardware"
               },
               model: {
+                description: "Device model-related properties.",
                 properties: {
                   accessory_keypad_supported: {
                     deprecated: true,
@@ -22176,28 +23371,30 @@ var openapi_default = {
                     "x-deprecated": "use device.properties.model.can_connect_accessory_keypad"
                   },
                   can_connect_accessory_keypad: {
-                    description: "Indicates whether the device can connect a accessory keypad.",
+                    description: "\n          Indicates whether the device can connect a accessory keypad.\n      ",
                     type: "boolean"
                   },
                   display_name: {
-                    description: "Display name of the device model.",
+                    description: "\n          Display name of the device model.\n      ",
                     type: "string"
                   },
                   has_built_in_keypad: {
-                    description: "Indicates whether the device has a built in accessory keypad.",
+                    description: "\n          Indicates whether the device has a built in accessory keypad.\n      ",
                     type: "boolean"
                   },
                   manufacturer_display_name: {
-                    description: "Display name that corresponds to the manufacturer-specific terminology for the device.",
+                    description: "\n          Display name that corresponds to the manufacturer-specific terminology for the device.\n      ",
                     type: "string"
                   },
                   offline_access_codes_supported: {
-                    description: "Indicates whether the device supports offline access codes.",
-                    type: "boolean"
+                    deprecated: true,
+                    type: "boolean",
+                    "x-deprecated": "use device.can_program_offline_access_codes."
                   },
                   online_access_codes_supported: {
-                    description: "Indicates whether the device supports online access codes.",
-                    type: "boolean"
+                    deprecated: true,
+                    type: "boolean",
+                    "x-deprecated": "use device.can_program_online_access_codes."
                   }
                 },
                 required: ["display_name", "manufacturer_display_name"],
@@ -22211,7 +23408,8 @@ var openapi_default = {
               },
               offline_access_codes_enabled: {
                 description: "Indicates whether it is currently possible to use offline access codes for the device.",
-                type: "boolean"
+                type: "boolean",
+                "x-property-group-key": "access_codes"
               },
               online: {
                 description: "Indicates whether the device is online.",
@@ -22219,11 +23417,21 @@ var openapi_default = {
               },
               online_access_codes_enabled: {
                 description: "Indicates whether it is currently possible to use online access codes for the device.",
-                type: "boolean"
+                type: "boolean",
+                "x-property-group-key": "access_codes"
               }
             },
             required: ["name", "online", "model"],
-            type: "object"
+            type: "object",
+            "x-property-groups": {
+              access_codes: { name: "access codes" },
+              hardware: { name: "hardware" },
+              locks: { name: "locks" },
+              noise_sensors: { name: "noise sensors" },
+              phones: { name: "phones" },
+              provider_metadata: { name: "provider metadata" },
+              thermostats: { name: "thermostats" }
+            }
           },
           warnings: {
             description: '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.',
@@ -22492,6 +23700,15 @@ var openapi_default = {
           "properties"
         ],
         type: "object",
+        "x-property-groups": {
+          access_codes: { name: "Access Codes" },
+          hardware: { name: "Hardware" },
+          locks: { name: "Locks" },
+          noise_sensors: { name: "Noise Sensors" },
+          phones: { name: "Phones" },
+          provider_metadata: { name: "Provider Metadata" },
+          thermostats: { name: "Thermostats" }
+        },
         "x-route-path": "/devices/unmanaged"
       },
       user_identity: {
@@ -22634,6 +23851,11 @@ var openapi_default = {
         scheme: "bearer",
         type: "http"
       },
+      customer_client_session: {
+        bearerFormat: "Customer Client Session Token",
+        scheme: "bearer",
+        type: "http"
+      },
       pat_with_workspace: {
         bearerFormat: "API Token",
         scheme: "bearer",
@@ -28591,6 +29813,8 @@ var openapi_default = {
                     items: { type: "string" },
                     type: "array"
                   },
+                  customer_id: { type: "string" },
+                  customer_key: { type: "string" },
                   expires_at: {
                     description: "Date and time at which the client session should expire, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.",
                     format: "date-time",
@@ -28665,6 +29889,8 @@ var openapi_default = {
                     items: { type: "string" },
                     type: "array"
                   },
+                  customer_id: { type: "string" },
+                  customer_key: { type: "string" },
                   expires_at: {
                     description: "Date and time at which the client session should expire, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.",
                     format: "date-time",
@@ -29259,6 +30485,7 @@ var openapi_default = {
                     description: "URL that you want to redirect the user to after the provider login is complete.",
                     type: "string"
                   },
+                  customer_id: { format: "uuid", type: "string" },
                   device_selection_mode: {
                     enum: ["none", "single", "multiple"],
                     type: "string",
@@ -29310,6 +30537,7 @@ var openapi_default = {
         },
         security: [
           { client_session: [] },
+          { customer_client_session: [] },
           { pat_with_workspace: [] },
           { console_session_with_workspace: [] },
           { api_key: [] }
@@ -29446,6 +30674,7 @@ var openapi_default = {
                     description: "Custom metadata pairs by which you want to [filter Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews/filtering-connect-webviews-by-custom-metadata). Returns Connect Webviews with `custom_metadata` that contains all of the provided key:value pairs.",
                     type: "object"
                   },
+                  customer_id: { type: "string" },
                   limit: {
                     default: 500,
                     description: "Maximum number of records to return per page.",
@@ -29486,6 +30715,7 @@ var openapi_default = {
         },
         security: [
           { client_session: [] },
+          { customer_client_session: [] },
           { pat_with_workspace: [] },
           { console_session_with_workspace: [] },
           { api_key: [] }
@@ -29984,6 +31214,7 @@ var openapi_default = {
                     description: "Device type for which you want to list devices.",
                     oneOf: [
                       {
+                        description: "Device type for smartlocks.\n          ",
                         enum: [
                           "akuvox_lock",
                           "august_lock",
@@ -30016,10 +31247,12 @@ var openapi_default = {
                         type: "string"
                       },
                       {
+                        description: "Device type for noise sensors.\n          ",
                         enum: ["noiseaware_activity_zone", "minut_sensor"],
                         type: "string"
                       },
                       {
+                        description: "Device type for thermostats.\n          ",
                         enum: [
                           "ecobee_thermostat",
                           "nest_thermostat",
@@ -30031,7 +31264,7 @@ var openapi_default = {
                         type: "string"
                       },
                       {
-                        description: "Type of phone.",
+                        description: "Device type for phones.\n          ",
                         enum: ["ios_phone", "android_phone"],
                         type: "string"
                       }
@@ -30042,6 +31275,7 @@ var openapi_default = {
                     items: {
                       oneOf: [
                         {
+                          description: "Device type for smartlocks.\n          ",
                           enum: [
                             "akuvox_lock",
                             "august_lock",
@@ -30074,10 +31308,12 @@ var openapi_default = {
                           type: "string"
                         },
                         {
+                          description: "Device type for noise sensors.\n          ",
                           enum: ["noiseaware_activity_zone", "minut_sensor"],
                           type: "string"
                         },
                         {
+                          description: "Device type for thermostats.\n          ",
                           enum: [
                             "ecobee_thermostat",
                             "nest_thermostat",
@@ -30089,7 +31325,7 @@ var openapi_default = {
                           type: "string"
                         },
                         {
-                          description: "Type of phone.",
+                          description: "Device type for phones.\n          ",
                           enum: ["ios_phone", "android_phone"],
                           type: "string"
                         }
@@ -30568,6 +31804,7 @@ var openapi_default = {
                     description: "Device type for which you want to list devices.",
                     oneOf: [
                       {
+                        description: "Device type for smartlocks.\n          ",
                         enum: [
                           "akuvox_lock",
                           "august_lock",
@@ -30600,10 +31837,12 @@ var openapi_default = {
                         type: "string"
                       },
                       {
+                        description: "Device type for noise sensors.\n          ",
                         enum: ["noiseaware_activity_zone", "minut_sensor"],
                         type: "string"
                       },
                       {
+                        description: "Device type for thermostats.\n          ",
                         enum: [
                           "ecobee_thermostat",
                           "nest_thermostat",
@@ -30615,7 +31854,7 @@ var openapi_default = {
                         type: "string"
                       },
                       {
-                        description: "Type of phone.",
+                        description: "Device type for phones.\n          ",
                         enum: ["ios_phone", "android_phone"],
                         type: "string"
                       }
@@ -30626,6 +31865,7 @@ var openapi_default = {
                     items: {
                       oneOf: [
                         {
+                          description: "Device type for smartlocks.\n          ",
                           enum: [
                             "akuvox_lock",
                             "august_lock",
@@ -30658,10 +31898,12 @@ var openapi_default = {
                           type: "string"
                         },
                         {
+                          description: "Device type for noise sensors.\n          ",
                           enum: ["noiseaware_activity_zone", "minut_sensor"],
                           type: "string"
                         },
                         {
+                          description: "Device type for thermostats.\n          ",
                           enum: [
                             "ecobee_thermostat",
                             "nest_thermostat",
@@ -30673,7 +31915,7 @@ var openapi_default = {
                           type: "string"
                         },
                         {
-                          description: "Type of phone.",
+                          description: "Device type for phones.\n          ",
                           enum: ["ios_phone", "android_phone"],
                           type: "string"
                         }
@@ -31562,6 +32804,7 @@ var openapi_default = {
                   device_types: {
                     description: "Array of device types by which to filter devices.",
                     items: {
+                      description: "Device type for smartlocks.\n          ",
                       enum: [
                         "akuvox_lock",
                         "august_lock",
@@ -32087,6 +33330,7 @@ var openapi_default = {
                   device_types: {
                     description: "Array of device types by which to filter devices.",
                     items: {
+                      description: "Device type for noise sensors.\n          ",
                       enum: ["noiseaware_activity_zone", "minut_sensor"],
                       type: "string"
                     },
@@ -34134,6 +35378,85 @@ var openapi_default = {
         "x-undocumented": "Mobile SDK only."
       }
     },
+    "/seam/partner/v1/resources/list": {
+      post: {
+        description: "List partner resources that have been pushed to Seam.",
+        operationId: "seamPartnerV1ResourcesListPost",
+        requestBody: {
+          content: {
+            "application/json": {
+              schema: {
+                properties: {
+                  resource_type_alias: {
+                    description: "Filter by resource type alias.",
+                    type: "string"
+                  }
+                },
+                type: "object"
+              }
+            }
+          }
+        },
+        responses: {
+          200: {
+            content: {
+              "application/json": {
+                schema: {
+                  properties: {
+                    ok: { type: "boolean" },
+                    partner_resources: {
+                      items: {
+                        properties: {
+                          custom_metadata: {
+                            additionalProperties: { type: "string" },
+                            type: "object"
+                          },
+                          customer_key: { type: "string" },
+                          description: { type: "string" },
+                          email_address: { type: "string" },
+                          ends_at: { type: "string" },
+                          location_keys: {
+                            items: { type: "string" },
+                            type: "array"
+                          },
+                          name: { type: "string" },
+                          partner_resource_key: { type: "string" },
+                          partner_resource_type: { type: "string" },
+                          phone_number: { type: "string" },
+                          starts_at: { type: "string" },
+                          user_identity_key: { type: "string" }
+                        },
+                        required: [
+                          "partner_resource_type",
+                          "partner_resource_key",
+                          "customer_key"
+                        ],
+                        type: "object"
+                      },
+                      type: "array"
+                    }
+                  },
+                  required: ["partner_resources", "ok"],
+                  type: "object"
+                }
+              }
+            },
+            description: "OK"
+          },
+          400: { description: "Bad Request" },
+          401: { description: "Unauthorized" }
+        },
+        security: [{ customer_client_session: [] }],
+        summary: "/seam/partner/v1/resources/list",
+        tags: [],
+        "x-fern-sdk-group-name": ["seam", "partner", "v1", "resources"],
+        "x-fern-sdk-method-name": "list",
+        "x-fern-sdk-return-value": "partner_resources",
+        "x-response-key": "partner_resources",
+        "x-title": "List partner resources at Seam",
+        "x-undocumented": "Partner building blocks/UI only."
+      }
+    },
     "/thermostats/activate_climate_preset": {
       post: {
         description: "Activates a specified [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) for a specified [thermostat](https://docs.seam.co/latest/capability-guides/thermostats).",
@@ -35046,6 +36369,7 @@ var openapi_default = {
                   device_types: {
                     description: "Array of device types by which to filter thermostat devices.",
                     items: {
+                      description: "Device type for thermostats.\n          ",
                       enum: [
                         "ecobee_thermostat",
                         "nest_thermostat",
@@ -38370,6 +39694,190 @@ var openapi_default = {
         "x-undocumented": "Experimental locations."
       }
     },
+    "/unstable_partner/building_blocks/generate_link": {
+      post: {
+        description: "Creates a new bridge client session.",
+        operationId: "unstablePartnerBuildingBlocksGenerateLinkPost",
+        requestBody: {
+          content: {
+            "application/json": {
+              schema: {
+                properties: {
+                  bridge_client_machine_identifier_key: { type: "string" },
+                  bridge_client_name: { type: "string" },
+                  bridge_client_time_zone: { type: "string" }
+                },
+                required: [
+                  "bridge_client_name",
+                  "bridge_client_time_zone",
+                  "bridge_client_machine_identifier_key"
+                ],
+                type: "object"
+              }
+            }
+          }
+        },
+        responses: {
+          200: {
+            content: {
+              "application/json": {
+                schema: {
+                  properties: {
+                    bridge_client_session: {
+                      properties: {
+                        bridge_client_machine_identifier_key: {
+                          type: "string"
+                        },
+                        bridge_client_name: { type: "string" },
+                        bridge_client_session_id: {
+                          format: "uuid",
+                          type: "string"
+                        },
+                        bridge_client_session_token: { type: "string" },
+                        bridge_client_time_zone: { type: "string" },
+                        created_at: { format: "date-time", type: "string" },
+                        errors: {
+                          items: {
+                            description: "Error associated with the `bridge_client_session`.",
+                            discriminator: { propertyName: "error_code" },
+                            oneOf: [
+                              {
+                                description: "Seam cannot reach the bridge's LAN",
+                                properties: {
+                                  can_tailscale_proxy_reach_bridge: {
+                                    description: "Tailscale proxy cannot reach the bridge",
+                                    nullable: true,
+                                    type: "boolean"
+                                  },
+                                  can_tailscale_proxy_reach_tailscale_network: {
+                                    description: "Tailscale proxy cannot reach the Tailscale network",
+                                    nullable: true,
+                                    type: "boolean"
+                                  },
+                                  created_at: {
+                                    format: "date-time",
+                                    type: "string"
+                                  },
+                                  error_code: {
+                                    description: "Unique identifier of the type of error. Enables quick recognition and categorization of the issue.",
+                                    enum: ["bridge_lan_unreachable"],
+                                    type: "string"
+                                  },
+                                  is_bridge_socks_server_healthy: {
+                                    description: "Bridge's SOCKS server is unhealthy",
+                                    nullable: true,
+                                    type: "boolean"
+                                  },
+                                  is_tailscale_proxy_reachable: {
+                                    description: "Seam cannot reach the tailscale proxy",
+                                    nullable: true,
+                                    type: "boolean"
+                                  },
+                                  is_tailscale_proxy_socks_server_healthy: {
+                                    description: "Tailscale proxy's SOCKS server is unhealthy",
+                                    nullable: true,
+                                    type: "boolean"
+                                  },
+                                  message: { type: "string" }
+                                },
+                                required: [
+                                  "message",
+                                  "created_at",
+                                  "error_code",
+                                  "is_tailscale_proxy_reachable",
+                                  "is_tailscale_proxy_socks_server_healthy",
+                                  "can_tailscale_proxy_reach_tailscale_network",
+                                  "can_tailscale_proxy_reach_bridge",
+                                  "is_bridge_socks_server_healthy"
+                                ],
+                                type: "object"
+                              },
+                              {
+                                description: "Bridge has stopped communicating with Seam",
+                                properties: {
+                                  created_at: {
+                                    format: "date-time",
+                                    type: "string"
+                                  },
+                                  error_code: {
+                                    description: "Unique identifier of the type of error. Enables quick recognition and categorization of the issue.",
+                                    enum: ["no_communication_from_bridge"],
+                                    type: "string"
+                                  },
+                                  message: { type: "string" }
+                                },
+                                required: [
+                                  "message",
+                                  "created_at",
+                                  "error_code"
+                                ],
+                                type: "object"
+                              }
+                            ]
+                          },
+                          type: "array"
+                        },
+                        pairing_code: {
+                          maxLength: 6,
+                          minLength: 6,
+                          type: "string"
+                        },
+                        pairing_code_expires_at: {
+                          format: "date-time",
+                          type: "string"
+                        },
+                        tailscale_auth_key: { nullable: true, type: "string" },
+                        tailscale_hostname: { type: "string" },
+                        telemetry_token: { nullable: true, type: "string" },
+                        telemetry_token_expires_at: {
+                          format: "date-time",
+                          nullable: true,
+                          type: "string"
+                        },
+                        telemetry_url: { nullable: true, type: "string" }
+                      },
+                      required: [
+                        "created_at",
+                        "bridge_client_session_id",
+                        "bridge_client_session_token",
+                        "pairing_code",
+                        "pairing_code_expires_at",
+                        "tailscale_hostname",
+                        "tailscale_auth_key",
+                        "bridge_client_name",
+                        "bridge_client_time_zone",
+                        "bridge_client_machine_identifier_key",
+                        "errors",
+                        "telemetry_token",
+                        "telemetry_token_expires_at",
+                        "telemetry_url"
+                      ],
+                      type: "object",
+                      "x-route-path": "/seam/bridge/v1/bridge_client_sessions",
+                      "x-undocumented": "Seam Bridge Client only."
+                    },
+                    ok: { type: "boolean" }
+                  },
+                  required: ["bridge_client_session", "ok"],
+                  type: "object"
+                }
+              }
+            },
+            description: "OK"
+          },
+          400: { description: "Bad Request" },
+          401: { description: "Unauthorized" }
+        },
+        security: [{ certified_client: [] }],
+        summary: "/unstable_partner/building_blocks/generate_link",
+        tags: [],
+        "x-fern-sdk-group-name": ["unstable_partner", "building_blocks"],
+        "x-fern-sdk-method-name": "generate_link",
+        "x-fern-sdk-return-value": "bridge_client_session",
+        "x-response-key": "bridge_client_session",
+        "x-title": "Generate a building block magic link"
+      }
+    },
     "/unstable_partner/resources/push": {
       post: {
         description: "Send Seam some of your resources.",
@@ -38390,7 +39898,6 @@ var openapi_default = {
                         description: { type: "string" },
                         email_address: { type: "string" },
                         ends_at: { type: "string" },
-                        icon_url: { type: "string" },
                         location_keys: {
                           items: { type: "string" },
                           type: "array"
@@ -38416,7 +39923,6 @@ var openapi_default = {
                       description: { type: "string" },
                       email_address: { type: "string" },
                       ends_at: { type: "string" },
-                      icon_url: { type: "string" },
                       location_keys: {
                         items: { type: "string" },
                         type: "array"