@seamapi/types 1.290.0 → 1.292.0

package/dist/connect.cjs

@@ -144,31 +144,47 @@ zod.z.array(fan_mode_setting);
 
 // src/lib/seam/connect/models/thermostats/climate-preset.ts
 var climate_preset = zod.z.object({
-  climate_preset_key: zod.z.string(),
-  can_edit: zod.z.boolean(),
-  can_delete: zod.z.boolean(),
-  name: zod.z.string().nullable().default(null).optional(),
-  display_name: zod.z.string(),
-  fan_mode_setting: fan_mode_setting.optional(),
-  hvac_mode_setting: hvac_mode_setting.optional(),
-  cooling_set_point_celsius: zod.z.number().optional(),
-  heating_set_point_celsius: zod.z.number().optional(),
-  cooling_set_point_fahrenheit: zod.z.number().optional(),
-  heating_set_point_fahrenheit: zod.z.number().optional(),
-  manual_override_allowed: zod.z.boolean()
+  climate_preset_key: zod.z.string().describe("Unique key to identify the climate preset."),
+  can_edit: zod.z.boolean().describe("Indicates whether this climate preset key can be edited."),
+  can_delete: zod.z.boolean().describe("Indicates whether this climate preset key can be deleted."),
+  name: zod.z.string().nullable().default(null).optional().describe("User-friendly name to identify the climate preset."),
+  display_name: zod.z.string().describe("Display name for the climate preset."),
+  fan_mode_setting: fan_mode_setting.optional().describe(
+    "Desired fan mode setting, such as `on`, `auto`, or `circulate`."
+  ),
+  hvac_mode_setting: hvac_mode_setting.optional().describe(
+    "Desired [HVAC mode](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/hvac-mode) setting, such as `heat`, `cool`, `heat_cool`, or `off`."
+  ),
+  cooling_set_point_celsius: zod.z.number().optional().describe(
+    "Temperature to which the thermostat should cool (in \xB0C). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points)."
+  ),
+  heating_set_point_celsius: zod.z.number().optional().describe("Temperature to which the thermostat should heat (in \xB0C)."),
+  cooling_set_point_fahrenheit: zod.z.number().optional().describe("Temperature to which the thermostat should cool (in \xB0F)."),
+  heating_set_point_fahrenheit: zod.z.number().optional().describe("Temperature to which the thermostat should heat (in \xB0F)."),
+  manual_override_allowed: zod.z.boolean().describe(
+    "Indicates whether a person at the thermostat can change the thermostat's settings."
+  )
 });
 var climate_setting = climate_preset.partial();
 var thermostat_schedule = zod.z.object({
-  thermostat_schedule_id: zod.z.string().uuid(),
-  device_id: zod.z.string().uuid(),
-  name: zod.z.string().optional(),
-  climate_preset_key: zod.z.string(),
-  max_override_period_minutes: zod.z.number().int().nonnegative(),
-  starts_at: zod.z.string().datetime(),
-  ends_at: zod.z.string().datetime(),
-  created_at: zod.z.string().datetime(),
+  thermostat_schedule_id: zod.z.string().uuid().describe("ID of the climate schedule."),
+  device_id: zod.z.string().uuid().describe("ID of the desired thermostat device."),
+  name: zod.z.string().optional().describe("User-friendly name to identify the climate schedule."),
+  climate_preset_key: zod.z.string().describe(
+    "Key of the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) to use for the climate schedule."
+  ),
+  max_override_period_minutes: zod.z.number().int().nonnegative().describe(
+    "Number of minutes for which a person at the thermostat can change the thermostat's settings after the activation of the scheduled climate preset. See also [Specifying Manual Override Permissions](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-schedules#specifying-manual-override-permissions)."
+  ),
+  starts_at: zod.z.string().datetime().describe(
+    "Date and time at which the climate schedule starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format."
+  ),
+  ends_at: zod.z.string().datetime().describe(
+    "Date and time at which the climate schedule ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format."
+  ),
+  created_at: zod.z.string().datetime().describe("Date and time at which the climate schedule was created."),
   errors: zod.z.any().describe(
-    'Collection of errors associated with the thermostat schedule, structured in a dictionary format. A unique "error_code" keys each error. Each error entry is an object containing two fields: "message" and "created_at." "message" is a string that describes the error. "created_at" is a date that indicates when the error was generated. This structure enables detailed tracking and timely response to critical issues.'
+    "Array of errors associated with the climate schedule. Each error object within the array contains two fields: `error_code` and `message`. `error_code` is a string that uniquely identifies the type of error, enabling quick recognition and categorization of the issue. `message` provides a more detailed description of the error, offering insights into the issue and potentially how to rectify it."
   )
 });
 
@@ -1381,20 +1397,20 @@ var visionline_instance_unreachable = common_acs_system_error.extend({
   For example, the IP address of the on-premises access control system may be set incorrectly within the Seam [workspace](https://docs.seam.co/latest/core-concepts/workspaces).
   See also [Troubleshooting Your Access Control System](https://docs.seam.co/latest/capability-guides/capability-guides/access-systems/troubleshooting-your-access-control-system#acs_system.errors.visionline_instance_unreachable).`);
 var salto_ks_subscription_limit_exceeded = common_acs_system_error.extend({
-  error_code: zod.z.literal("salto_ks_subscription_limit_exceeded").describe(
-    "Indicates that the maximum number of users allowed for the site has been reached. This means that new access codes cannot be created. Contact Salto support to increase the user limit."
-  )
-});
+  error_code: zod.z.literal("salto_ks_subscription_limit_exceeded").describe(error_code_description)
+}).describe(
+  "Indicates that the maximum number of users allowed for the site has been reached. This means that new access codes cannot be created. Contact Salto support to increase the user limit."
+);
 var acs_system_disconnected = common_acs_system_error.extend({
-  error_code: zod.z.literal("acs_system_disconnected").describe(
-    "Indicates that the access system has been disconnected. Please refer to [this guide](https://docs.seam.co/latest/capability-guides/access-systems/troubleshooting-your-access-control-system guide) to resolve the issue."
-  )
-});
+  error_code: zod.z.literal("acs_system_disconnected").describe(error_code_description)
+}).describe(
+  "Indicates that the access system has been disconnected. See [this guide](https://docs.seam.co/latest/capability-guides/access-systems/troubleshooting-your-access-control-system guide) to resolve the issue."
+);
 var account_disconnected = common_acs_system_error.extend({
-  error_code: zod.z.literal("account_disconnected").describe(
-    "Indicates that the login credentials are invalid. Please reconnect the account using the Connect Webview to restore access."
-  )
-});
+  error_code: zod.z.literal("account_disconnected").describe(error_code_description)
+}).describe(
+  "Indicates that the login credentials are invalid. Reconnect the account using the Connect Webview to restore access."
+);
 var acs_system_error = zod.z.union([
   seam_bridge_disconnected,
   visionline_instance_unreachable,
@@ -2237,6 +2253,19 @@ var acs_credential_events = [
   acs_credential_deleted_event,
   acs_credential_issued
 ];
+var acs_encoder_event = common_acs_event.extend({
+  acs_encoder_id: zod.z.string().uuid().describe("ID of the ACS encoder.")
+});
+var acs_encoder_added_event = acs_encoder_event.extend({
+  event_type: zod.z.literal("acs_encoder.added")
+}).describe("An ACS encoder was added.");
+var acs_encoder_removed_event = acs_encoder_event.extend({
+  event_type: zod.z.literal("acs_encoder.removed")
+}).describe("An ACS encoder was removed.");
+var acs_encoder_events = [
+  acs_encoder_added_event,
+  acs_encoder_removed_event
+];
 var acs_system_event = common_acs_event.extend({});
 var acs_system_connected_event = acs_system_event.extend({
   event_type: zod.z.literal("acs_system.connected")
@@ -2260,7 +2289,8 @@ var acs_user_events = [acs_user_deleted_event];
 var acs_events = [
   ...acs_system_events,
   ...acs_credential_events,
-  ...acs_user_events
+  ...acs_user_events,
+  ...acs_encoder_events
 ];
 var action_attempt_event = common_event.extend({
   action_attempt_id: zod.z.string().uuid().describe(`
@@ -3379,6 +3409,7 @@ var openapi_default = {
                   type: "object"
                 },
                 {
+                  description: "Indicates that the maximum number of users allowed for the site has been reached. This means that new access codes cannot be created. Contact Salto support to increase the user limit.",
                   properties: {
                     created_at: {
                       description: "Date and time at which Seam created the error.",
@@ -3386,7 +3417,7 @@ var openapi_default = {
                       type: "string"
                     },
                     error_code: {
-                      description: "Indicates that the maximum number of users allowed for the site has been reached. This means that new access codes cannot be created. Contact Salto support to increase the user limit.",
+                      description: "Unique identifier of the type of error. Enables quick recognition and categorization of the issue.",
                       enum: ["salto_ks_subscription_limit_exceeded"],
                       type: "string"
                     },
@@ -3399,6 +3430,7 @@ var openapi_default = {
                   type: "object"
                 },
                 {
+                  description: "Indicates that the access system has been disconnected. See [this guide](https://docs.seam.co/latest/capability-guides/access-systems/troubleshooting-your-access-control-system guide) to resolve the issue.",
                   properties: {
                     created_at: {
                       description: "Date and time at which Seam created the error.",
@@ -3406,7 +3438,7 @@ var openapi_default = {
                       type: "string"
                     },
                     error_code: {
-                      description: "Indicates that the access system has been disconnected. Please refer to [this guide](https://docs.seam.co/latest/capability-guides/access-systems/troubleshooting-your-access-control-system guide) to resolve the issue.",
+                      description: "Unique identifier of the type of error. Enables quick recognition and categorization of the issue.",
                       enum: ["acs_system_disconnected"],
                       type: "string"
                     },
@@ -3419,6 +3451,7 @@ var openapi_default = {
                   type: "object"
                 },
                 {
+                  description: "Indicates that the login credentials are invalid. Reconnect the account using the Connect Webview to restore access.",
                   properties: {
                     created_at: {
                       description: "Date and time at which Seam created the error.",
@@ -3426,7 +3459,7 @@ var openapi_default = {
                       type: "string"
                     },
                     error_code: {
-                      description: "Indicates that the login credentials are invalid. Please reconnect the account using the Connect Webview to restore access.",
+                      description: "Unique identifier of the type of error. Enables quick recognition and categorization of the issue.",
                       enum: ["account_disconnected"],
                       type: "string"
                     },
@@ -7142,20 +7175,44 @@ var openapi_default = {
                         default: null,
                         nullable: true,
                         properties: {
-                          climate_preset_key: { type: "string" },
-                          created_at: { format: "date-time", type: "string" },
-                          device_id: { format: "uuid", type: "string" },
-                          ends_at: { format: "date-time", type: "string" },
+                          climate_preset_key: {
+                            description: "Key of the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) to use for the climate schedule.",
+                            type: "string"
+                          },
+                          created_at: {
+                            description: "Date and time at which the climate schedule was created.",
+                            format: "date-time",
+                            type: "string"
+                          },
+                          device_id: {
+                            description: "ID of the desired thermostat device.",
+                            format: "uuid",
+                            type: "string"
+                          },
+                          ends_at: {
+                            description: "Date and time at which the climate schedule ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.",
+                            format: "date-time",
+                            type: "string"
+                          },
                           errors: {
-                            description: 'Collection of errors associated with the thermostat schedule, structured in a dictionary format. A unique "error_code" keys each error. Each error entry is an object containing two fields: "message" and "created_at." "message" is a string that describes the error. "created_at" is a date that indicates when the error was generated. This structure enables detailed tracking and timely response to critical issues.'
+                            description: "Array of errors associated with the climate schedule. Each error object within the array contains two fields: `error_code` and `message`. `error_code` is a string that uniquely identifies the type of error, enabling quick recognition and categorization of the issue. `message` provides a more detailed description of the error, offering insights into the issue and potentially how to rectify it."
                           },
                           max_override_period_minutes: {
+                            description: "Number of minutes for which a person at the thermostat can change the thermostat's settings after the activation of the scheduled climate preset. See also [Specifying Manual Override Permissions](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-schedules#specifying-manual-override-permissions).",
                             minimum: 0,
                             type: "integer"
                           },
-                          name: { type: "string" },
-                          starts_at: { format: "date-time", type: "string" },
+                          name: {
+                            description: "User-friendly name to identify the climate schedule.",
+                            type: "string"
+                          },
+                          starts_at: {
+                            description: "Date and time at which the climate schedule starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.",
+                            format: "date-time",
+                            type: "string"
+                          },
                           thermostat_schedule_id: {
+                            description: "ID of the climate schedule.",
                             format: "uuid",
                             type: "string"
                           }
@@ -7174,37 +7231,59 @@ var openapi_default = {
                       available_climate_presets: {
                         items: {
                           properties: {
-                            can_delete: { type: "boolean" },
-                            can_edit: { type: "boolean" },
-                            climate_preset_key: { type: "string" },
+                            can_delete: {
+                              description: "Indicates whether this climate preset key can be deleted.",
+                              type: "boolean"
+                            },
+                            can_edit: {
+                              description: "Indicates whether this climate preset key can be edited.",
+                              type: "boolean"
+                            },
+                            climate_preset_key: {
+                              description: "Unique key to identify the climate preset.",
+                              type: "string"
+                            },
                             cooling_set_point_celsius: {
+                              description: "Temperature to which the thermostat should cool (in \xB0C). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).",
                               format: "float",
                               type: "number"
                             },
                             cooling_set_point_fahrenheit: {
+                              description: "Temperature to which the thermostat should cool (in \xB0F).",
                               format: "float",
                               type: "number"
                             },
-                            display_name: { type: "string" },
+                            display_name: {
+                              description: "Display name for the climate preset.",
+                              type: "string"
+                            },
                             fan_mode_setting: {
+                              description: "Desired fan mode setting, such as `on`, `auto`, or `circulate`.",
                               enum: ["auto", "on", "circulate"],
                               type: "string"
                             },
                             heating_set_point_celsius: {
+                              description: "Temperature to which the thermostat should heat (in \xB0C).",
                               format: "float",
                               type: "number"
                             },
                             heating_set_point_fahrenheit: {
+                              description: "Temperature to which the thermostat should heat (in \xB0F).",
                               format: "float",
                               type: "number"
                             },
                             hvac_mode_setting: {
+                              description: "Desired [HVAC mode](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/hvac-mode) setting, such as `heat`, `cool`, `heat_cool`, or `off`.",
                               enum: ["off", "heat", "cool", "heat_cool"],
                               type: "string"
                             },
-                            manual_override_allowed: { type: "boolean" },
+                            manual_override_allowed: {
+                              description: "Indicates whether a person at the thermostat can change the thermostat's settings.",
+                              type: "boolean"
+                            },
                             name: {
                               default: null,
+                              description: "User-friendly name to identify the climate preset.",
                               nullable: true,
                               type: "string"
                             }
@@ -7236,37 +7315,59 @@ var openapi_default = {
                       },
                       current_climate_setting: {
                         properties: {
-                          can_delete: { type: "boolean" },
-                          can_edit: { type: "boolean" },
-                          climate_preset_key: { type: "string" },
+                          can_delete: {
+                            description: "Indicates whether this climate preset key can be deleted.",
+                            type: "boolean"
+                          },
+                          can_edit: {
+                            description: "Indicates whether this climate preset key can be edited.",
+                            type: "boolean"
+                          },
+                          climate_preset_key: {
+                            description: "Unique key to identify the climate preset.",
+                            type: "string"
+                          },
                           cooling_set_point_celsius: {
+                            description: "Temperature to which the thermostat should cool (in \xB0C). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).",
                             format: "float",
                             type: "number"
                           },
                           cooling_set_point_fahrenheit: {
+                            description: "Temperature to which the thermostat should cool (in \xB0F).",
                             format: "float",
                             type: "number"
                           },
-                          display_name: { type: "string" },
+                          display_name: {
+                            description: "Display name for the climate preset.",
+                            type: "string"
+                          },
                           fan_mode_setting: {
+                            description: "Desired fan mode setting, such as `on`, `auto`, or `circulate`.",
                             enum: ["auto", "on", "circulate"],
                             type: "string"
                           },
                           heating_set_point_celsius: {
+                            description: "Temperature to which the thermostat should heat (in \xB0C).",
                             format: "float",
                             type: "number"
                           },
                           heating_set_point_fahrenheit: {
+                            description: "Temperature to which the thermostat should heat (in \xB0F).",
                             format: "float",
                             type: "number"
                           },
                           hvac_mode_setting: {
+                            description: "Desired [HVAC mode](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/hvac-mode) setting, such as `heat`, `cool`, `heat_cool`, or `off`.",
                             enum: ["off", "heat", "cool", "heat_cool"],
                             type: "string"
                           },
-                          manual_override_allowed: { type: "boolean" },
+                          manual_override_allowed: {
+                            description: "Indicates whether a person at the thermostat can change the thermostat's settings.",
+                            type: "boolean"
+                          },
                           name: {
                             default: null,
+                            description: "User-friendly name to identify the climate preset.",
                             nullable: true,
                             type: "string"
                           }
@@ -7276,37 +7377,59 @@ var openapi_default = {
                       default_climate_setting: {
                         deprecated: true,
                         properties: {
-                          can_delete: { type: "boolean" },
-                          can_edit: { type: "boolean" },
-                          climate_preset_key: { type: "string" },
+                          can_delete: {
+                            description: "Indicates whether this climate preset key can be deleted.",
+                            type: "boolean"
+                          },
+                          can_edit: {
+                            description: "Indicates whether this climate preset key can be edited.",
+                            type: "boolean"
+                          },
+                          climate_preset_key: {
+                            description: "Unique key to identify the climate preset.",
+                            type: "string"
+                          },
                           cooling_set_point_celsius: {
+                            description: "Temperature to which the thermostat should cool (in \xB0C). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).",
                             format: "float",
                             type: "number"
                           },
                           cooling_set_point_fahrenheit: {
+                            description: "Temperature to which the thermostat should cool (in \xB0F).",
                             format: "float",
                             type: "number"
                           },
-                          display_name: { type: "string" },
+                          display_name: {
+                            description: "Display name for the climate preset.",
+                            type: "string"
+                          },
                           fan_mode_setting: {
+                            description: "Desired fan mode setting, such as `on`, `auto`, or `circulate`.",
                             enum: ["auto", "on", "circulate"],
                             type: "string"
                           },
                           heating_set_point_celsius: {
+                            description: "Temperature to which the thermostat should heat (in \xB0C).",
                             format: "float",
                             type: "number"
                           },
                           heating_set_point_fahrenheit: {
+                            description: "Temperature to which the thermostat should heat (in \xB0F).",
                             format: "float",
                             type: "number"
                           },
                           hvac_mode_setting: {
+                            description: "Desired [HVAC mode](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/hvac-mode) setting, such as `heat`, `cool`, `heat_cool`, or `off`.",
                             enum: ["off", "heat", "cool", "heat_cool"],
                             type: "string"
                           },
-                          manual_override_allowed: { type: "boolean" },
+                          manual_override_allowed: {
+                            description: "Indicates whether a person at the thermostat can change the thermostat's settings.",
+                            type: "boolean"
+                          },
                           name: {
                             default: null,
+                            description: "User-friendly name to identify the climate preset.",
                             nullable: true,
                             type: "string"
                           }
@@ -7800,17 +7923,47 @@ var openapi_default = {
       },
       thermostat_schedule: {
         properties: {
-          climate_preset_key: { type: "string" },
-          created_at: { format: "date-time", type: "string" },
-          device_id: { format: "uuid", type: "string" },
-          ends_at: { format: "date-time", type: "string" },
+          climate_preset_key: {
+            description: "Key of the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) to use for the climate schedule.",
+            type: "string"
+          },
+          created_at: {
+            description: "Date and time at which the climate schedule was created.",
+            format: "date-time",
+            type: "string"
+          },
+          device_id: {
+            description: "ID of the desired thermostat device.",
+            format: "uuid",
+            type: "string"
+          },
+          ends_at: {
+            description: "Date and time at which the climate schedule ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.",
+            format: "date-time",
+            type: "string"
+          },
           errors: {
-            description: 'Collection of errors associated with the thermostat schedule, structured in a dictionary format. A unique "error_code" keys each error. Each error entry is an object containing two fields: "message" and "created_at." "message" is a string that describes the error. "created_at" is a date that indicates when the error was generated. This structure enables detailed tracking and timely response to critical issues.'
+            description: "Array of errors associated with the climate schedule. Each error object within the array contains two fields: `error_code` and `message`. `error_code` is a string that uniquely identifies the type of error, enabling quick recognition and categorization of the issue. `message` provides a more detailed description of the error, offering insights into the issue and potentially how to rectify it."
           },
-          max_override_period_minutes: { minimum: 0, type: "integer" },
-          name: { type: "string" },
-          starts_at: { format: "date-time", type: "string" },
-          thermostat_schedule_id: { format: "uuid", type: "string" }
+          max_override_period_minutes: {
+            description: "Number of minutes for which a person at the thermostat can change the thermostat's settings after the activation of the scheduled climate preset. See also [Specifying Manual Override Permissions](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-schedules#specifying-manual-override-permissions).",
+            minimum: 0,
+            type: "integer"
+          },
+          name: {
+            description: "User-friendly name to identify the climate schedule.",
+            type: "string"
+          },
+          starts_at: {
+            description: "Date and time at which the climate schedule starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.",
+            format: "date-time",
+            type: "string"
+          },
+          thermostat_schedule_id: {
+            description: "ID of the climate schedule.",
+            format: "uuid",
+            type: "string"
+          }
         },
         required: [
           "thermostat_schedule_id",
@@ -14949,34 +15102,47 @@ var openapi_default = {
     },
     "/devices/list": {
       post: {
+        description: "Returns a list of all [devices](https://docs.seam.co/latest/core-concepts/devices).",
         operationId: "devicesListPost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  connect_webview_id: { format: "uuid", type: "string" },
+                  connect_webview_id: {
+                    description: "ID of the Connect Webview by which to filter devices.",
+                    format: "uuid",
+                    type: "string"
+                  },
                   connected_account_id: {
-                    description: "List all devices owned by this connected account",
+                    description: "ID of the connected account by which to filter.",
                     format: "uuid",
                     type: "string"
                   },
                   connected_account_ids: {
+                    description: "Array of IDs of the connected accounts by which to filter devices.",
                     items: { format: "uuid", type: "string" },
                     type: "array"
                   },
-                  created_before: { format: "date-time", type: "string" },
+                  created_before: {
+                    description: "Date threshold for devices to return. If specified, returns only devices created before the specified date.",
+                    format: "date-time",
+                    type: "string"
+                  },
                   custom_metadata_has: {
                     additionalProperties: {
                       oneOf: [{ type: "string" }, { type: "boolean" }]
                     },
+                    description: "Set of key:value [custom metadata](https://docs.seam.co/latest/core-concepts/devices/adding-custom-metadata-to-a-device) pairs by which you want to filter devices.",
                     type: "object"
                   },
                   device_ids: {
+                    description: "Array of device IDs by which to filter devices.",
                     items: { format: "uuid", type: "string" },
                     type: "array"
                   },
                   device_type: {
+                    description: "Device type by which to filter devices.",
                     oneOf: [
                       {
                         enum: [
@@ -15033,6 +15199,7 @@ var openapi_default = {
                     ]
                   },
                   device_types: {
+                    description: "Array of device types by which to filter devices.",
                     items: {
                       oneOf: [
                         {
@@ -15111,7 +15278,8 @@ var openapi_default = {
                       ],
                       type: "string"
                     },
-                    type: "array"
+                    type: "array",
+                    "x-undocumented": "Only used internally."
                   },
                   include_if: {
                     items: {
@@ -15130,10 +15298,17 @@ var openapi_default = {
                       ],
                       type: "string"
                     },
-                    type: "array"
+                    type: "array",
+                    "x-undocumented": "Only used internally."
+                  },
+                  limit: {
+                    default: 500,
+                    description: "Numerical limit on the number of devices to return.",
+                    format: "float",
+                    type: "number"
                   },
-                  limit: { default: 500, format: "float", type: "number" },
                   manufacturer: {
+                    description: "Manufacturer by which to filter devices.",
                     enum: [
                       "akuvox",
                       "august",
@@ -15173,7 +15348,10 @@ var openapi_default = {
                     ],
                     type: "string"
                   },
-                  user_identifier_key: { type: "string" }
+                  user_identifier_key: {
+                    description: "Your own internal user ID for the user by which to filter devices.",
+                    type: "string"
+                  }
                 },
                 type: "object"
               }
@@ -15213,7 +15391,8 @@ var openapi_default = {
         "x-fern-sdk-group-name": ["devices"],
         "x-fern-sdk-method-name": "list",
         "x-fern-sdk-return-value": "devices",
-        "x-response-key": "devices"
+        "x-response-key": "devices",
+        "x-title": "List Devices"
       }
     },
     "/devices/list_device_providers": {
@@ -15459,28 +15638,40 @@ var openapi_default = {
             "application/json": {
               schema: {
                 properties: {
-                  connect_webview_id: { format: "uuid", type: "string" },
+                  connect_webview_id: {
+                    description: "ID of the Connect Webview by which to filter devices.",
+                    format: "uuid",
+                    type: "string"
+                  },
                   connected_account_id: {
-                    description: "List all devices owned by this connected account",
+                    description: "ID of the connected account by which to filter.",
                     format: "uuid",
                     type: "string"
                   },
                   connected_account_ids: {
+                    description: "Array of IDs of the connected accounts by which to filter devices.",
                     items: { format: "uuid", type: "string" },
                     type: "array"
                   },
-                  created_before: { format: "date-time", type: "string" },
+                  created_before: {
+                    description: "Date threshold for devices to return. If specified, returns only devices created before the specified date.",
+                    format: "date-time",
+                    type: "string"
+                  },
                   custom_metadata_has: {
                     additionalProperties: {
                       oneOf: [{ type: "string" }, { type: "boolean" }]
                     },
+                    description: "Set of key:value [custom metadata](https://docs.seam.co/latest/core-concepts/devices/adding-custom-metadata-to-a-device) pairs by which you want to filter devices.",
                     type: "object"
                   },
                   device_ids: {
+                    description: "Array of device IDs by which to filter devices.",
                     items: { format: "uuid", type: "string" },
                     type: "array"
                   },
                   device_type: {
+                    description: "Device type by which to filter devices.",
                     oneOf: [
                       {
                         enum: [
@@ -15537,6 +15728,7 @@ var openapi_default = {
                     ]
                   },
                   device_types: {
+                    description: "Array of device types by which to filter devices.",
                     items: {
                       oneOf: [
                         {
@@ -15615,7 +15807,8 @@ var openapi_default = {
                       ],
                       type: "string"
                     },
-                    type: "array"
+                    type: "array",
+                    "x-undocumented": "Only used internally."
                   },
                   include_if: {
                     items: {
@@ -15634,10 +15827,17 @@ var openapi_default = {
                       ],
                       type: "string"
                     },
-                    type: "array"
+                    type: "array",
+                    "x-undocumented": "Only used internally."
+                  },
+                  limit: {
+                    default: 500,
+                    description: "Numerical limit on the number of devices to return.",
+                    format: "float",
+                    type: "number"
                   },
-                  limit: { default: 500, format: "float", type: "number" },
                   manufacturer: {
+                    description: "Manufacturer by which to filter devices.",
                     enum: [
                       "akuvox",
                       "august",
@@ -15677,7 +15877,10 @@ var openapi_default = {
                     ],
                     type: "string"
                   },
-                  user_identifier_key: { type: "string" }
+                  user_identifier_key: {
+                    description: "Your own internal user ID for the user by which to filter devices.",
+                    type: "string"
+                  }
                 },
                 type: "object"
               }
@@ -16070,6 +16273,8 @@ var openapi_default = {
                       "acs_user.deleted",
                       "acs_credential.deleted",
                       "acs_credential.issued",
+                      "acs_encoder.added",
+                      "acs_encoder.removed",
                       "enrollment_automation.deleted",
                       "client_session.deleted",
                       "action_attempt.lock_door.succeeded",
@@ -16144,6 +16349,8 @@ var openapi_default = {
                         "acs_user.deleted",
                         "acs_credential.deleted",
                         "acs_credential.issued",
+                        "acs_encoder.added",
+                        "acs_encoder.removed",
                         "enrollment_automation.deleted",
                         "client_session.deleted",
                         "action_attempt.lock_door.succeeded",
@@ -16263,28 +16470,40 @@ var openapi_default = {
             "application/json": {
               schema: {
                 properties: {
-                  connect_webview_id: { format: "uuid", type: "string" },
+                  connect_webview_id: {
+                    description: "ID of the Connect Webview by which to filter devices.",
+                    format: "uuid",
+                    type: "string"
+                  },
                   connected_account_id: {
-                    description: "List all devices owned by this connected account",
+                    description: "ID of the connected account by which to filter.",
                     format: "uuid",
                     type: "string"
                   },
                   connected_account_ids: {
+                    description: "Array of IDs of the connected accounts by which to filter devices.",
                     items: { format: "uuid", type: "string" },
                     type: "array"
                   },
-                  created_before: { format: "date-time", type: "string" },
+                  created_before: {
+                    description: "Date threshold for devices to return. If specified, returns only devices created before the specified date.",
+                    format: "date-time",
+                    type: "string"
+                  },
                   custom_metadata_has: {
                     additionalProperties: {
                       oneOf: [{ type: "string" }, { type: "boolean" }]
                     },
+                    description: "Set of key:value [custom metadata](https://docs.seam.co/latest/core-concepts/devices/adding-custom-metadata-to-a-device) pairs by which you want to filter devices.",
                     type: "object"
                   },
                   device_ids: {
+                    description: "Array of device IDs by which to filter devices.",
                     items: { format: "uuid", type: "string" },
                     type: "array"
                   },
                   device_type: {
+                    description: "Device type by which to filter devices.",
                     oneOf: [
                       {
                         enum: [
@@ -16341,6 +16560,7 @@ var openapi_default = {
                     ]
                   },
                   device_types: {
+                    description: "Array of device types by which to filter devices.",
                     items: {
                       oneOf: [
                         {
@@ -16419,7 +16639,8 @@ var openapi_default = {
                       ],
                       type: "string"
                     },
-                    type: "array"
+                    type: "array",
+                    "x-undocumented": "Only used internally."
                   },
                   include_if: {
                     items: {
@@ -16438,10 +16659,17 @@ var openapi_default = {
                       ],
                       type: "string"
                     },
-                    type: "array"
+                    type: "array",
+                    "x-undocumented": "Only used internally."
+                  },
+                  limit: {
+                    default: 500,
+                    description: "Numerical limit on the number of devices to return.",
+                    format: "float",
+                    type: "number"
                   },
-                  limit: { default: 500, format: "float", type: "number" },
                   manufacturer: {
+                    description: "Manufacturer by which to filter devices.",
                     enum: [
                       "akuvox",
                       "august",
@@ -16481,7 +16709,10 @@ var openapi_default = {
                     ],
                     type: "string"
                   },
-                  user_identifier_key: { type: "string" }
+                  user_identifier_key: {
+                    description: "Your own internal user ID for the user by which to filter devices.",
+                    type: "string"
+                  }
                 },
                 type: "object"
               }
@@ -16729,28 +16960,40 @@ var openapi_default = {
             "application/json": {
               schema: {
                 properties: {
-                  connect_webview_id: { format: "uuid", type: "string" },
+                  connect_webview_id: {
+                    description: "ID of the Connect Webview by which to filter devices.",
+                    format: "uuid",
+                    type: "string"
+                  },
                   connected_account_id: {
-                    description: "List all devices owned by this connected account",
+                    description: "ID of the connected account by which to filter.",
                     format: "uuid",
                     type: "string"
                   },
                   connected_account_ids: {
+                    description: "Array of IDs of the connected accounts by which to filter devices.",
                     items: { format: "uuid", type: "string" },
                     type: "array"
                   },
-                  created_before: { format: "date-time", type: "string" },
+                  created_before: {
+                    description: "Date threshold for devices to return. If specified, returns only devices created before the specified date.",
+                    format: "date-time",
+                    type: "string"
+                  },
                   custom_metadata_has: {
                     additionalProperties: {
                       oneOf: [{ type: "string" }, { type: "boolean" }]
                     },
+                    description: "Set of key:value [custom metadata](https://docs.seam.co/latest/core-concepts/devices/adding-custom-metadata-to-a-device) pairs by which you want to filter devices.",
                     type: "object"
                   },
                   device_ids: {
+                    description: "Array of device IDs by which to filter devices.",
                     items: { format: "uuid", type: "string" },
                     type: "array"
                   },
                   device_type: {
+                    description: "Device type by which to filter devices.",
                     oneOf: [
                       {
                         enum: [
@@ -16807,6 +17050,7 @@ var openapi_default = {
                     ]
                   },
                   device_types: {
+                    description: "Array of device types by which to filter devices.",
                     items: {
                       oneOf: [
                         {
@@ -16885,7 +17129,8 @@ var openapi_default = {
                       ],
                       type: "string"
                     },
-                    type: "array"
+                    type: "array",
+                    "x-undocumented": "Only used internally."
                   },
                   include_if: {
                     items: {
@@ -16904,10 +17149,17 @@ var openapi_default = {
                       ],
                       type: "string"
                     },
-                    type: "array"
+                    type: "array",
+                    "x-undocumented": "Only used internally."
+                  },
+                  limit: {
+                    default: 500,
+                    description: "Numerical limit on the number of devices to return.",
+                    format: "float",
+                    type: "number"
                   },
-                  limit: { default: 500, format: "float", type: "number" },
                   manufacturer: {
+                    description: "Manufacturer by which to filter devices.",
                     enum: [
                       "akuvox",
                       "august",
@@ -16947,7 +17199,10 @@ var openapi_default = {
                     ],
                     type: "string"
                   },
-                  user_identifier_key: { type: "string" }
+                  user_identifier_key: {
+                    description: "Your own internal user ID for the user by which to filter devices.",
+                    type: "string"
+                  }
                 },
                 type: "object"
               }
@@ -17592,14 +17847,22 @@ var openapi_default = {
     },
     "/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).",
         operationId: "thermostatsActivateClimatePresetPost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  climate_preset_key: { type: "string" },
-                  device_id: { format: "uuid", type: "string" }
+                  climate_preset_key: {
+                    description: "Climate preset key of the desired climate preset.",
+                    type: "string"
+                  },
+                  device_id: {
+                    description: "ID of the desired thermostat device.",
+                    format: "uuid",
+                    type: "string"
+                  }
                 },
                 required: ["device_id", "climate_preset_key"],
                 type: "object"
@@ -17638,12 +17901,13 @@ var openapi_default = {
         "x-fern-sdk-group-name": ["thermostats"],
         "x-fern-sdk-method-name": "activate_climate_preset",
         "x-fern-sdk-return-value": "action_attempt",
-        "x-response-key": "action_attempt"
+        "x-response-key": "action_attempt",
+        "x-title": "Activate a Climate Preset"
       }
     },
     "/thermostats/cool": {
       post: {
-        description: "Sets a thermostat to cooling mode. You must include a cooling set point in Celsius or Fahrenheit. See also [Setting the Current HVAC and Fan Mode Settings](https://docs.seam.co/latest/capability-guides/thermostats/configure-current-climate-settings).",
+        description: "Sets a specified [thermostat](https://docs.seam.co/latest/capability-guides/thermostats) to [cool mode](https://docs.seam.co/latest/capability-guides/thermostats/configure-current-climate-settings).",
         operationId: "thermostatsCoolPost",
         requestBody: {
           content: {
@@ -17651,21 +17915,25 @@ var openapi_default = {
               schema: {
                 properties: {
                   cooling_set_point_celsius: {
-                    description: "Temperature to which the HVAC system connected to the thermostat should cool (in \xB0C). You must set one of the `cooling_set_point` parameters.",
+                    description: "Desired [cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in \xB0C. You must set one of the `cooling_set_point` parameters.",
                     format: "float",
                     type: "number"
                   },
                   cooling_set_point_fahrenheit: {
-                    description: "Temperature to which the HVAC system connected to the thermostat should cool (in \xB0F). You must set one of the `cooling_set_point` parameters.",
+                    description: "Desired [cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in \xB0F. You must set one of the `cooling_set_point` parameters.",
                     format: "float",
                     type: "number"
                   },
                   device_id: {
-                    description: "ID of the thermostat device.",
+                    description: "ID of the desired thermostat device.",
                     format: "uuid",
                     type: "string"
                   },
-                  sync: { default: false, type: "boolean" }
+                  sync: {
+                    default: false,
+                    type: "boolean",
+                    "x-undocumented": "Only used internally."
+                  }
                 },
                 required: ["device_id"],
                 type: "object"
@@ -17711,40 +17979,62 @@ var openapi_default = {
     },
     "/thermostats/create_climate_preset": {
       post: {
+        description: "Creates a [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).",
         operationId: "thermostatsCreateClimatePresetPost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  climate_preset_key: { type: "string" },
+                  climate_preset_key: {
+                    description: "Unique key to identify the climate preset.",
+                    type: "string"
+                  },
                   cooling_set_point_celsius: {
+                    description: "Temperature to which the thermostat should cool (in \xB0C). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).",
                     format: "float",
                     type: "number"
                   },
                   cooling_set_point_fahrenheit: {
+                    description: "Temperature to which the thermostat should cool (in \xB0F).",
                     format: "float",
                     type: "number"
                   },
-                  device_id: { format: "uuid", type: "string" },
+                  device_id: {
+                    description: "ID of the desired thermostat device.",
+                    format: "uuid",
+                    type: "string"
+                  },
                   fan_mode_setting: {
+                    description: "Desired fan mode setting, such as `on`, `auto`, or `circulate`.",
                     enum: ["auto", "on", "circulate"],
                     type: "string"
                   },
                   heating_set_point_celsius: {
+                    description: "Temperature to which the thermostat should heat (in \xB0C).",
                     format: "float",
                     type: "number"
                   },
                   heating_set_point_fahrenheit: {
+                    description: "Temperature to which the thermostat should heat (in \xB0F).",
                     format: "float",
                     type: "number"
                   },
                   hvac_mode_setting: {
+                    description: "Desired [HVAC mode](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/hvac-mode) setting, such as `heat`, `cool`, `heat_cool`, or `off`.",
                     enum: ["off", "heat", "cool", "heat_cool"],
                     type: "string"
                   },
-                  manual_override_allowed: { type: "boolean" },
-                  name: { default: null, nullable: true, type: "string" }
+                  manual_override_allowed: {
+                    description: "Indicates whether a person at the thermostat can change the thermostat's settings.",
+                    type: "boolean"
+                  },
+                  name: {
+                    default: null,
+                    description: "User-friendly name to identify the climate preset.",
+                    nullable: true,
+                    type: "string"
+                  }
                 },
                 required: [
                   "device_id",
@@ -17781,19 +18071,28 @@ var openapi_default = {
         tags: ["/thermostats"],
         "x-fern-sdk-group-name": ["thermostats"],
         "x-fern-sdk-method-name": "create_climate_preset",
-        "x-response-key": null
+        "x-response-key": null,
+        "x-title": "Create a Climate Preset"
       }
     },
     "/thermostats/delete_climate_preset": {
       post: {
+        description: "Deletes 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).",
         operationId: "thermostatsDeleteClimatePresetPost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  climate_preset_key: { type: "string" },
-                  device_id: { format: "uuid", type: "string" }
+                  climate_preset_key: {
+                    description: "Climate preset key of the desired climate preset.",
+                    type: "string"
+                  },
+                  device_id: {
+                    description: "ID of the desired thermostat device.",
+                    format: "uuid",
+                    type: "string"
+                  }
                 },
                 required: ["device_id", "climate_preset_key"],
                 type: "object"
@@ -17826,12 +18125,13 @@ var openapi_default = {
         tags: ["/thermostats"],
         "x-fern-sdk-group-name": ["thermostats"],
         "x-fern-sdk-method-name": "delete_climate_preset",
-        "x-response-key": null
+        "x-response-key": null,
+        "x-title": "Delete a Climate Preset"
       }
     },
     "/thermostats/get": {
       post: {
-        description: "Returns a specific thermostat.",
+        description: "Returns a specified [thermostat](https://docs.seam.co/latest/capability-guides/thermostats).",
         operationId: "thermostatsGetPost",
         requestBody: {
           content: {
@@ -17839,12 +18139,12 @@ var openapi_default = {
               schema: {
                 properties: {
                   device_id: {
-                    description: "ID of the thermostat device.",
+                    description: "ID of the desired thermostat device.",
                     format: "uuid",
                     type: "string"
                   },
                   name: {
-                    description: "Name of the thermostat.",
+                    description: "User-friendly name of the desired thermostat device.",
                     type: "string"
                   }
                 },
@@ -17885,12 +18185,13 @@ var openapi_default = {
         "x-fern-sdk-method-name": "get",
         "x-fern-sdk-return-value": "thermostat",
         "x-response-key": "thermostat",
-        "x-title": "Get a Thermostat"
+        "x-title": "Get a Thermostat",
+        "x-undocumented": "Will be removed."
       }
     },
     "/thermostats/heat": {
       post: {
-        description: "Sets a thermostat to heating mode. You must include a heating set point in Celsius or Fahrenheit. See also [Setting the Current HVAC and Fan Mode Settings](https://docs.seam.co/latest/capability-guides/thermostats/configure-current-climate-settings).",
+        description: "Sets a specified [thermostat](https://docs.seam.co/latest/capability-guides/thermostats) to [heat mode](https://docs.seam.co/latest/capability-guides/thermostats/configure-current-climate-settings).",
         operationId: "thermostatsHeatPost",
         requestBody: {
           content: {
@@ -17898,21 +18199,25 @@ var openapi_default = {
               schema: {
                 properties: {
                   device_id: {
-                    description: "ID of the thermostat device.",
+                    description: "ID of the desired thermostat device.",
                     format: "uuid",
                     type: "string"
                   },
                   heating_set_point_celsius: {
-                    description: "Temperature to which the HVAC system connected to the thermostat should heat (in \xB0C). You must set one of the `heating_set_point` parameters.",
+                    description: "Desired [heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in \xB0C. You must set one of the `heating_set_point` parameters.",
                     format: "float",
                     type: "number"
                   },
                   heating_set_point_fahrenheit: {
-                    description: "Temperature to which the HVAC system connected to the thermostat should heat (in \xB0F). You must set one of the `heating_set_point` parameters.",
+                    description: "Desired [heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in \xB0F. You must set one of the `heating_set_point` parameters.",
                     format: "float",
                     type: "number"
                   },
-                  sync: { default: false, type: "boolean" }
+                  sync: {
+                    default: false,
+                    type: "boolean",
+                    "x-undocumented": "Only used internally."
+                  }
                 },
                 required: ["device_id"],
                 type: "object"
@@ -17958,7 +18263,7 @@ var openapi_default = {
     },
     "/thermostats/heat_cool": {
       post: {
-        description: 'Set a thermostat to heat-cool mode, also known as "auto" mode. To do so, you must include both cooling and heating set points in the payload, either in Celsius or Fahrenheit. For information about verifying the heating and cooling availability of the thermostat and validating the correct set points, see [HVAC Mode Constraints](https://docs.seam.co/latest/capability-guides/thermostats/hvac-mode#hvac-mode-constraints) and [Set Point Constraints](https://docs.seam.co/latest/capability-guides/thermostats/set-points#set-point-constraints).',
+        description: 'Sets a specified [thermostat](https://docs.seam.co/latest/capability-guides/thermostats) to [heat-cool ("auto") mode](https://docs.seam.co/latest/capability-guides/thermostats/configure-current-climate-settings).',
         operationId: "thermostatsHeatCoolPost",
         requestBody: {
           content: {
@@ -17966,31 +18271,35 @@ var openapi_default = {
               schema: {
                 properties: {
                   cooling_set_point_celsius: {
-                    description: "Temperature to which the HVAC system connected to the thermostat should cool (in \xB0C). You must set one of the `cooling_set_point` parameters.",
+                    description: "Desired [cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in \xB0C. You must set one of the `cooling_set_point` parameters.",
                     format: "float",
                     type: "number"
                   },
                   cooling_set_point_fahrenheit: {
-                    description: "Temperature the thermostat should cool to (in \xB0F). You must set one of the cooling_set_point parameters.",
+                    description: "Desired [cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in \xB0F. You must set one of the `cooling_set_point` parameters.",
                     format: "float",
                     type: "number"
                   },
                   device_id: {
-                    description: "ID of the thermostat device.",
+                    description: "ID of the desired thermostat device.",
                     format: "uuid",
                     type: "string"
                   },
                   heating_set_point_celsius: {
-                    description: "Temperature to which the HVAC system connected to the thermostat should heat (in \xB0C). You must set one of the `heating_set_point` parameters.",
+                    description: "Desired [heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in \xB0C. You must set one of the `heating_set_point` parameters.",
                     format: "float",
                     type: "number"
                   },
                   heating_set_point_fahrenheit: {
-                    description: "Temperature the thermostat should heat to (in \xB0F). You must set one of the heating_set_point parameters.",
+                    description: "Desired [heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in \xB0F. You must set one of the `heating_set_point` parameters.",
                     format: "float",
                     type: "number"
                   },
-                  sync: { default: false, type: "boolean" }
+                  sync: {
+                    default: false,
+                    type: "boolean",
+                    "x-undocumented": "Only used internally."
+                  }
                 },
                 required: ["device_id"],
                 type: "object"
@@ -18036,35 +18345,47 @@ var openapi_default = {
     },
     "/thermostats/list": {
       post: {
-        description: "Returns a list of thermostats connected to your workspace. If no thermostats are connected, the list will be empty.",
+        description: "Returns a list of all [thermostats](https://docs.seam.co/latest/capability-guides/thermostats).",
         operationId: "thermostatsListPost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  connect_webview_id: { format: "uuid", type: "string" },
+                  connect_webview_id: {
+                    description: "ID of the Connect Webview by which to filter devices.",
+                    format: "uuid",
+                    type: "string"
+                  },
                   connected_account_id: {
-                    description: "List all devices owned by this connected account",
+                    description: "ID of the connected account by which to filter.",
                     format: "uuid",
                     type: "string"
                   },
                   connected_account_ids: {
+                    description: "Array of IDs of the connected accounts by which to filter devices.",
                     items: { format: "uuid", type: "string" },
                     type: "array"
                   },
-                  created_before: { format: "date-time", type: "string" },
+                  created_before: {
+                    description: "Date threshold for devices to return. If specified, returns only devices created before the specified date.",
+                    format: "date-time",
+                    type: "string"
+                  },
                   custom_metadata_has: {
                     additionalProperties: {
                       oneOf: [{ type: "string" }, { type: "boolean" }]
                     },
+                    description: "Set of key:value [custom metadata](https://docs.seam.co/latest/core-concepts/devices/adding-custom-metadata-to-a-device) pairs by which you want to filter devices.",
                     type: "object"
                   },
                   device_ids: {
+                    description: "Array of device IDs by which to filter devices.",
                     items: { format: "uuid", type: "string" },
                     type: "array"
                   },
                   device_type: {
+                    description: "Device type by which to filter devices.",
                     oneOf: [
                       {
                         enum: [
@@ -18121,6 +18442,7 @@ var openapi_default = {
                     ]
                   },
                   device_types: {
+                    description: "Array of device types by which to filter devices.",
                     items: {
                       oneOf: [
                         {
@@ -18199,7 +18521,8 @@ var openapi_default = {
                       ],
                       type: "string"
                     },
-                    type: "array"
+                    type: "array",
+                    "x-undocumented": "Only used internally."
                   },
                   include_if: {
                     items: {
@@ -18218,10 +18541,17 @@ var openapi_default = {
                       ],
                       type: "string"
                     },
-                    type: "array"
+                    type: "array",
+                    "x-undocumented": "Only used internally."
+                  },
+                  limit: {
+                    default: 500,
+                    description: "Numerical limit on the number of devices to return.",
+                    format: "float",
+                    type: "number"
                   },
-                  limit: { default: 500, format: "float", type: "number" },
                   manufacturer: {
+                    description: "Manufacturer by which to filter devices.",
                     enum: [
                       "akuvox",
                       "august",
@@ -18261,7 +18591,10 @@ var openapi_default = {
                     ],
                     type: "string"
                   },
-                  user_identifier_key: { type: "string" }
+                  user_identifier_key: {
+                    description: "Your own internal user ID for the user by which to filter devices.",
+                    type: "string"
+                  }
                 },
                 type: "object"
               }
@@ -18311,7 +18644,7 @@ var openapi_default = {
     },
     "/thermostats/off": {
       post: {
-        description: 'Sets a thermostat to "off" mode. See also [Setting the Current HVAC and Fan Mode Settings](https://docs.seam.co/latest/capability-guides/thermostats/configure-current-climate-settings).',
+        description: 'Sets a specified [thermostat](https://docs.seam.co/latest/capability-guides/thermostats) to ["off" mode](https://docs.seam.co/latest/capability-guides/thermostats/configure-current-climate-settings).',
         operationId: "thermostatsOffPost",
         requestBody: {
           content: {
@@ -18319,11 +18652,15 @@ var openapi_default = {
               schema: {
                 properties: {
                   device_id: {
-                    description: "ID of the thermostat device.",
+                    description: "ID of the desired thermostat device.",
                     format: "uuid",
                     type: "string"
                   },
-                  sync: { default: false, type: "boolean" }
+                  sync: {
+                    default: false,
+                    type: "boolean",
+                    "x-undocumented": "Only used internally."
+                  }
                 },
                 required: ["device_id"],
                 type: "object"
@@ -18369,22 +18706,39 @@ var openapi_default = {
     },
     "/thermostats/schedules/create": {
       post: {
+        description: "Creates a [climate schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-schedules) for a specified [thermostat](https://docs.seam.co/latest/capability-guides/thermostats).",
         operationId: "thermostatsSchedulesCreatePost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  climate_preset_key: { type: "string" },
-                  device_id: { type: "string" },
-                  ends_at: { type: "string" },
+                  climate_preset_key: {
+                    description: "Key of the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) to use for the climate schedule.",
+                    type: "string"
+                  },
+                  device_id: {
+                    description: "ID of the desired thermostat device.",
+                    type: "string"
+                  },
+                  ends_at: {
+                    description: "Date and time at which the climate schedule ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.",
+                    type: "string"
+                  },
                   max_override_period_minutes: {
                     default: 0,
+                    description: "Number of minutes for which a person at the thermostat can change the thermostat's settings after the activation of the scheduled climate preset. See also [Specifying Manual Override Permissions](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-schedules#specifying-manual-override-permissions).",
                     minimum: 0,
                     type: "integer"
                   },
-                  name: { type: "string" },
-                  starts_at: { type: "string" }
+                  name: {
+                    description: "User-friendly name to identify the climate schedule.",
+                    type: "string"
+                  },
+                  starts_at: {
+                    description: "Date and time at which the climate schedule starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.",
+                    type: "string"
+                  }
                 },
                 required: [
                   "device_id",
@@ -18429,18 +18783,24 @@ var openapi_default = {
         "x-fern-sdk-group-name": ["thermostats", "schedules"],
         "x-fern-sdk-method-name": "create",
         "x-fern-sdk-return-value": "thermostat_schedule",
-        "x-response-key": "thermostat_schedule"
+        "x-response-key": "thermostat_schedule",
+        "x-title": "Create a Climate Schedule"
       }
     },
     "/thermostats/schedules/delete": {
       post: {
+        description: "Deletes a [climate schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-schedules) for a specified [thermostat](https://docs.seam.co/latest/capability-guides/thermostats).",
         operationId: "thermostatsSchedulesDeletePost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  thermostat_schedule_id: { format: "uuid", type: "string" }
+                  thermostat_schedule_id: {
+                    description: "ID of the desired climate schedule.",
+                    format: "uuid",
+                    type: "string"
+                  }
                 },
                 required: ["thermostat_schedule_id"],
                 type: "object"
@@ -18474,18 +18834,24 @@ var openapi_default = {
         tags: ["/thermostats"],
         "x-fern-sdk-group-name": ["thermostats", "schedules"],
         "x-fern-sdk-method-name": "delete",
-        "x-response-key": null
+        "x-response-key": null,
+        "x-title": "Delete a Climate Schedule"
       }
     },
     "/thermostats/schedules/get": {
       post: {
+        description: "Returns a specified [climate schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-schedules).",
         operationId: "thermostatsSchedulesGetPost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  thermostat_schedule_id: { format: "uuid", type: "string" }
+                  thermostat_schedule_id: {
+                    description: "ID of the desired climate schedule.",
+                    format: "uuid",
+                    type: "string"
+                  }
                 },
                 required: ["thermostat_schedule_id"],
                 type: "object"
@@ -18525,19 +18891,28 @@ var openapi_default = {
         "x-fern-sdk-group-name": ["thermostats", "schedules"],
         "x-fern-sdk-method-name": "get",
         "x-fern-sdk-return-value": "thermostat_schedule",
-        "x-response-key": "thermostat_schedule"
+        "x-response-key": "thermostat_schedule",
+        "x-title": "Get a Climate Schedule"
       }
     },
     "/thermostats/schedules/list": {
       post: {
+        description: "Returns a list of all [climate schedules](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-schedules) for a specified [thermostat](https://docs.seam.co/latest/capability-guides/thermostats).",
         operationId: "thermostatsSchedulesListPost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  device_id: { format: "uuid", type: "string" },
-                  user_identifier_key: { type: "string" }
+                  device_id: {
+                    description: "ID of the desired thermostat device.",
+                    format: "uuid",
+                    type: "string"
+                  },
+                  user_identifier_key: {
+                    description: "User identifier key by which to filter the list of returned climate schedules.",
+                    type: "string"
+                  }
                 },
                 required: ["device_id"],
                 type: "object"
@@ -18580,23 +18955,45 @@ var openapi_default = {
         "x-fern-sdk-group-name": ["thermostats", "schedules"],
         "x-fern-sdk-method-name": "list",
         "x-fern-sdk-return-value": "thermostat_schedules",
-        "x-response-key": "thermostat_schedules"
+        "x-response-key": "thermostat_schedules",
+        "x-title": "List Climate Schedules"
       }
     },
     "/thermostats/schedules/update": {
       patch: {
+        description: "Updates a specified [climate schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-schedules).",
         operationId: "thermostatsSchedulesUpdatePatch",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  climate_preset_key: { type: "string" },
-                  ends_at: { type: "string" },
-                  max_override_period_minutes: { minimum: 0, type: "integer" },
-                  name: { type: "string" },
-                  starts_at: { type: "string" },
-                  thermostat_schedule_id: { format: "uuid", type: "string" }
+                  climate_preset_key: {
+                    description: "Key of the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) to use for the climate schedule.",
+                    type: "string"
+                  },
+                  ends_at: {
+                    description: "Date and time at which the climate schedule ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.",
+                    type: "string"
+                  },
+                  max_override_period_minutes: {
+                    description: "Number of minutes for which a person at the thermostat can change the thermostat's settings after the activation of the scheduled climate preset. See also [Specifying Manual Override Permissions](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-schedules#specifying-manual-override-permissions).",
+                    minimum: 0,
+                    type: "integer"
+                  },
+                  name: {
+                    description: "User-friendly name to identify the climate schedule.",
+                    type: "string"
+                  },
+                  starts_at: {
+                    description: "Date and time at which the climate schedule starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.",
+                    type: "string"
+                  },
+                  thermostat_schedule_id: {
+                    description: "ID of the desired climate schedule.",
+                    format: "uuid",
+                    type: "string"
+                  }
                 },
                 required: ["thermostat_schedule_id"],
                 type: "object"
@@ -18629,21 +19026,43 @@ var openapi_default = {
         summary: "/thermostats/schedules/update",
         tags: ["/thermostats"],
         "x-fern-ignore": true,
-        "x-response-key": null
+        "x-response-key": null,
+        "x-title": "Update a Climate Schedule"
       },
       post: {
+        description: "Updates a specified [climate schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-schedules).",
         operationId: "thermostatsSchedulesUpdatePost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  climate_preset_key: { type: "string" },
-                  ends_at: { type: "string" },
-                  max_override_period_minutes: { minimum: 0, type: "integer" },
-                  name: { type: "string" },
-                  starts_at: { type: "string" },
-                  thermostat_schedule_id: { format: "uuid", type: "string" }
+                  climate_preset_key: {
+                    description: "Key of the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) to use for the climate schedule.",
+                    type: "string"
+                  },
+                  ends_at: {
+                    description: "Date and time at which the climate schedule ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.",
+                    type: "string"
+                  },
+                  max_override_period_minutes: {
+                    description: "Number of minutes for which a person at the thermostat can change the thermostat's settings after the activation of the scheduled climate preset. See also [Specifying Manual Override Permissions](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-schedules#specifying-manual-override-permissions).",
+                    minimum: 0,
+                    type: "integer"
+                  },
+                  name: {
+                    description: "User-friendly name to identify the climate schedule.",
+                    type: "string"
+                  },
+                  starts_at: {
+                    description: "Date and time at which the climate schedule starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.",
+                    type: "string"
+                  },
+                  thermostat_schedule_id: {
+                    description: "ID of the desired climate schedule.",
+                    format: "uuid",
+                    type: "string"
+                  }
                 },
                 required: ["thermostat_schedule_id"],
                 type: "object"
@@ -18677,19 +19096,28 @@ var openapi_default = {
         tags: ["/thermostats"],
         "x-fern-sdk-group-name": ["thermostats", "schedules"],
         "x-fern-sdk-method-name": "update",
-        "x-response-key": null
+        "x-response-key": null,
+        "x-title": "Update a Climate Schedule"
       }
     },
     "/thermostats/set_fallback_climate_preset": {
       post: {
+        description: 'Sets a specified [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) as the ["fallback"](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets/setting-the-fallback-climate-preset) preset for a specified [thermostat](https://docs.seam.co/latest/capability-guides/thermostats).',
         operationId: "thermostatsSetFallbackClimatePresetPost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  climate_preset_key: { type: "string" },
-                  device_id: { format: "uuid", type: "string" }
+                  climate_preset_key: {
+                    description: "Climate preset key of the desired climate preset.",
+                    type: "string"
+                  },
+                  device_id: {
+                    description: "ID of the desired thermostat device.",
+                    format: "uuid",
+                    type: "string"
+                  }
                 },
                 required: ["device_id", "climate_preset_key"],
                 type: "object"
@@ -18722,23 +19150,20 @@ var openapi_default = {
         tags: ["/thermostats"],
         "x-fern-sdk-group-name": ["thermostats"],
         "x-fern-sdk-method-name": "set_fallback_climate_preset",
-        "x-response-key": null
+        "x-response-key": null,
+        "x-title": "Set the Fallback Climate Preset"
       }
     },
     "/thermostats/set_fan_mode": {
       post: {
-        description: "Sets the fan mode setting for a thermostat. See also [Setting the Current HVAC and Fan Mode Settings](https://docs.seam.co/latest/capability-guides/thermostats/configure-current-climate-settings) and [Fan Mode Settings](https://docs.seam.co/latest/capability-guides/thermostats/configure-current-climate-settings#fan-mode-settings).",
+        description: "Sets the [fan mode setting](https://docs.seam.co/latest/capability-guides/thermostats/configure-current-climate-settings#fan-mode-settings) for a specified [thermostat](https://docs.seam.co/latest/capability-guides/thermostats).",
         operationId: "thermostatsSetFanModePost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  device_id: {
-                    description: "ID of the thermostat device.",
-                    format: "uuid",
-                    type: "string"
-                  },
+                  device_id: { format: "uuid", type: "string" },
                   fan_mode: {
                     deprecated: true,
                     enum: ["auto", "on", "circulate"],
@@ -18746,11 +19171,15 @@ var openapi_default = {
                     "x-deprecated": "Use `fan_mode_setting` instead."
                   },
                   fan_mode_setting: {
-                    description: "Fan mode setting of the thermostat. See also [Fan Mode Settings](https://docs.seam.co/latest/capability-guides/thermostats/configure-current-climate-settings#fan-mode-settings).",
+                    description: "Desired [fan mode setting](https://docs.seam.co/latest/capability-guides/thermostats/configure-current-climate-settings#fan-mode-settings) for the thermostat.",
                     enum: ["auto", "on", "circulate"],
                     type: "string"
                   },
-                  sync: { default: false, type: "boolean" }
+                  sync: {
+                    default: false,
+                    type: "boolean",
+                    "x-undocumented": "Only used internally."
+                  }
                 },
                 required: ["device_id"],
                 type: "object"
@@ -18791,38 +19220,47 @@ var openapi_default = {
         "x-fern-sdk-method-name": "set_fan_mode",
         "x-fern-sdk-return-value": "action_attempt",
         "x-response-key": "action_attempt",
-        "x-title": "Set Fan Mode Setting"
+        "x-title": "Set the Fan Mode Setting"
       }
     },
     "/thermostats/set_temperature_threshold": {
       patch: {
+        description: "Sets a [temperature threshold](https://docs.seam.co/latest/capability-guides/thermostats/setting-and-monitoring-temperature-thresholds) for a specified thermostat. Seam emits a `thermostat.temperature_threshold_exceeded` event and adds a warning on a thermostat if it reports a temperature outside the threshold range.",
         operationId: "thermostatsSetTemperatureThresholdPatch",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  device_id: { format: "uuid", type: "string" },
+                  device_id: {
+                    description: "ID of the desired thermostat device.",
+                    format: "uuid",
+                    type: "string"
+                  },
                   lower_limit_celsius: {
                     default: null,
+                    description: "Lower temperature limit in in \xB0C. Seam alerts you if the reported temperature is lower than this value. You can specify either `lower_limit` but not both.",
                     format: "float",
                     nullable: true,
                     type: "number"
                   },
                   lower_limit_fahrenheit: {
                     default: null,
+                    description: "Lower temperature limit in in \xB0F. Seam alerts you if the reported temperature is lower than this value. You can specify either `lower_limit` but not both.",
                     format: "float",
                     nullable: true,
                     type: "number"
                   },
                   upper_limit_celsius: {
                     default: null,
+                    description: "Upper temperature limit in in \xB0C. Seam alerts you if the reported temperature is higher than this value. You can specify either `upper_limit` but not both.",
                     format: "float",
                     nullable: true,
                     type: "number"
                   },
                   upper_limit_fahrenheit: {
                     default: null,
+                    description: "Upper temperature limit in in \xB0C. Seam alerts you if the reported temperature is higher than this value. You can specify either `upper_limit` but not both.",
                     format: "float",
                     nullable: true,
                     type: "number"
@@ -18858,36 +19296,46 @@ var openapi_default = {
         summary: "/thermostats/set_temperature_threshold",
         tags: ["/thermostats"],
         "x-fern-ignore": true,
-        "x-response-key": null
+        "x-response-key": null,
+        "x-title": "Set a Temperature Threshold"
       },
       post: {
+        description: "Sets a [temperature threshold](https://docs.seam.co/latest/capability-guides/thermostats/setting-and-monitoring-temperature-thresholds) for a specified thermostat. Seam emits a `thermostat.temperature_threshold_exceeded` event and adds a warning on a thermostat if it reports a temperature outside the threshold range.",
         operationId: "thermostatsSetTemperatureThresholdPost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  device_id: { format: "uuid", type: "string" },
+                  device_id: {
+                    description: "ID of the desired thermostat device.",
+                    format: "uuid",
+                    type: "string"
+                  },
                   lower_limit_celsius: {
                     default: null,
+                    description: "Lower temperature limit in in \xB0C. Seam alerts you if the reported temperature is lower than this value. You can specify either `lower_limit` but not both.",
                     format: "float",
                     nullable: true,
                     type: "number"
                   },
                   lower_limit_fahrenheit: {
                     default: null,
+                    description: "Lower temperature limit in in \xB0F. Seam alerts you if the reported temperature is lower than this value. You can specify either `lower_limit` but not both.",
                     format: "float",
                     nullable: true,
                     type: "number"
                   },
                   upper_limit_celsius: {
                     default: null,
+                    description: "Upper temperature limit in in \xB0C. Seam alerts you if the reported temperature is higher than this value. You can specify either `upper_limit` but not both.",
                     format: "float",
                     nullable: true,
                     type: "number"
                   },
                   upper_limit_fahrenheit: {
                     default: null,
+                    description: "Upper temperature limit in in \xB0C. Seam alerts you if the reported temperature is higher than this value. You can specify either `upper_limit` but not both.",
                     format: "float",
                     nullable: true,
                     type: "number"
@@ -18924,45 +19372,68 @@ var openapi_default = {
         tags: ["/thermostats"],
         "x-fern-sdk-group-name": ["thermostats"],
         "x-fern-sdk-method-name": "set_temperature_threshold",
-        "x-response-key": null
+        "x-response-key": null,
+        "x-title": "Set a Temperature Threshold"
       }
     },
     "/thermostats/update_climate_preset": {
       patch: {
+        description: "Updates 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).",
         operationId: "thermostatsUpdateClimatePresetPatch",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  climate_preset_key: { type: "string" },
+                  climate_preset_key: {
+                    description: "Unique key to identify the climate preset.",
+                    type: "string"
+                  },
                   cooling_set_point_celsius: {
+                    description: "Temperature to which the thermostat should cool (in \xB0C). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).",
                     format: "float",
                     type: "number"
                   },
                   cooling_set_point_fahrenheit: {
+                    description: "Temperature to which the thermostat should cool (in \xB0F).",
                     format: "float",
                     type: "number"
                   },
-                  device_id: { format: "uuid", type: "string" },
+                  device_id: {
+                    description: "ID of the desired thermostat device.",
+                    format: "uuid",
+                    type: "string"
+                  },
                   fan_mode_setting: {
+                    description: "Desired fan mode setting, such as `on`, `auto`, or `circulate`.",
                     enum: ["auto", "on", "circulate"],
                     type: "string"
                   },
                   heating_set_point_celsius: {
+                    description: "Temperature to which the thermostat should heat (in \xB0C).",
                     format: "float",
                     type: "number"
                   },
                   heating_set_point_fahrenheit: {
+                    description: "Temperature to which the thermostat should heat (in \xB0F).",
                     format: "float",
                     type: "number"
                   },
                   hvac_mode_setting: {
+                    description: "Desired [HVAC mode](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/hvac-mode) setting, such as `heat`, `cool`, `heat_cool`, or `off`.",
                     enum: ["off", "heat", "cool", "heat_cool"],
                     type: "string"
                   },
-                  manual_override_allowed: { type: "boolean" },
-                  name: { default: null, nullable: true, type: "string" }
+                  manual_override_allowed: {
+                    description: "Indicates whether a person at the thermostat can change the thermostat's settings.",
+                    type: "boolean"
+                  },
+                  name: {
+                    default: null,
+                    description: "User-friendly name to identify the climate preset.",
+                    nullable: true,
+                    type: "string"
+                  }
                 },
                 required: [
                   "device_id",
@@ -18998,43 +19469,66 @@ var openapi_default = {
         summary: "/thermostats/update_climate_preset",
         tags: ["/thermostats"],
         "x-fern-ignore": true,
-        "x-response-key": null
+        "x-response-key": null,
+        "x-title": "Update a Climate Preset"
       },
       post: {
+        description: "Updates 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).",
         operationId: "thermostatsUpdateClimatePresetPost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  climate_preset_key: { type: "string" },
+                  climate_preset_key: {
+                    description: "Unique key to identify the climate preset.",
+                    type: "string"
+                  },
                   cooling_set_point_celsius: {
+                    description: "Temperature to which the thermostat should cool (in \xB0C). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).",
                     format: "float",
                     type: "number"
                   },
                   cooling_set_point_fahrenheit: {
+                    description: "Temperature to which the thermostat should cool (in \xB0F).",
                     format: "float",
                     type: "number"
                   },
-                  device_id: { format: "uuid", type: "string" },
+                  device_id: {
+                    description: "ID of the desired thermostat device.",
+                    format: "uuid",
+                    type: "string"
+                  },
                   fan_mode_setting: {
+                    description: "Desired fan mode setting, such as `on`, `auto`, or `circulate`.",
                     enum: ["auto", "on", "circulate"],
                     type: "string"
                   },
                   heating_set_point_celsius: {
+                    description: "Temperature to which the thermostat should heat (in \xB0C).",
                     format: "float",
                     type: "number"
                   },
                   heating_set_point_fahrenheit: {
+                    description: "Temperature to which the thermostat should heat (in \xB0F).",
                     format: "float",
                     type: "number"
                   },
                   hvac_mode_setting: {
+                    description: "Desired [HVAC mode](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/hvac-mode) setting, such as `heat`, `cool`, `heat_cool`, or `off`.",
                     enum: ["off", "heat", "cool", "heat_cool"],
                     type: "string"
                   },
-                  manual_override_allowed: { type: "boolean" },
-                  name: { default: null, nullable: true, type: "string" }
+                  manual_override_allowed: {
+                    description: "Indicates whether a person at the thermostat can change the thermostat's settings.",
+                    type: "boolean"
+                  },
+                  name: {
+                    default: null,
+                    description: "User-friendly name to identify the climate preset.",
+                    nullable: true,
+                    type: "string"
+                  }
                 },
                 required: [
                   "device_id",
@@ -19071,7 +19565,8 @@ var openapi_default = {
         tags: ["/thermostats"],
         "x-fern-sdk-group-name": ["thermostats"],
         "x-fern-sdk-method-name": "update_climate_preset",
-        "x-response-key": null
+        "x-response-key": null,
+        "x-title": "Update a Climate Preset"
       }
     },
     "/user_identities/add_acs_user": {