npm - @seamapi/types - Versions diffs - 1.293.0 → 1.294.0 - Mend

@seamapi/types 1.293.0 → 1.294.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (20) hide show

package/dist/connect.cjs CHANGED Viewed

@@ -163,7 +163,11 @@ var climate_preset = zod.z.object({
   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."
+    `
+      ---
+      deprecated: Use 'thermostat_schedule.is_override_allowed'
+      ---
+      Indicates whether a person at the thermostat can change the thermostat's settings.`
   )
 });
 var climate_setting = climate_preset.partial();
@@ -2770,15 +2774,21 @@ var noise_threshold = zod.z.object({
   noise_threshold_decibels: zod.z.number()
 });
 var user_identity = zod.z.object({
-  user_identity_id: zod.z.string().uuid(),
-  user_identity_key: zod.z.string().min(1).nullable(),
-  email_address: zod.z.string().email().nullable(),
-  phone_number: phone_number.nullable(),
+  user_identity_id: zod.z.string().uuid().describe("ID of the user identity."),
+  user_identity_key: zod.z.string().min(1).nullable().describe("Unique key for the user identity."),
+  email_address: zod.z.string().email().nullable().describe("Unique email address for the user identity."),
+  phone_number: phone_number.nullable().describe(
+    "Unique phone number for the user identity in [E.164 format](https://www.itu.int/rec/T-REC-E.164/en) (for example, +15555550100)."
+  ),
   display_name: zod.z.string().min(1),
   full_name: zod.z.string().min(1).nullable(),
-  created_at: zod.z.string().datetime(),
-  workspace_id: zod.z.string().uuid()
-});
+  created_at: zod.z.string().datetime().describe("Date and time at which the user identity was created."),
+  workspace_id: zod.z.string().uuid().describe(
+    "ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the user identity."
+  )
+}).describe(
+  "Represents a [user identity](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) associated with an application user account."
+);
 var webhook = zod.z.object({
   webhook_id: zod.z.string(),
   url: zod.z.string(),
@@ -7326,8 +7336,10 @@ var openapi_default = {
                               type: "string"
                             },
                             manual_override_allowed: {
+                              deprecated: true,
                               description: "Indicates whether a person at the thermostat can change the thermostat's settings.",
-                              type: "boolean"
+                              type: "boolean",
+                              "x-deprecated": "Use 'thermostat_schedule.is_override_allowed'"
                             },
                             name: {
                               default: null,
@@ -7410,8 +7422,10 @@ var openapi_default = {
                             type: "string"
                           },
                           manual_override_allowed: {
+                            deprecated: true,
                             description: "Indicates whether a person at the thermostat can change the thermostat's settings.",
-                            type: "boolean"
+                            type: "boolean",
+                            "x-deprecated": "Use 'thermostat_schedule.is_override_allowed'"
                           },
                           name: {
                             default: null,
@@ -7472,8 +7486,10 @@ var openapi_default = {
                             type: "string"
                           },
                           manual_override_allowed: {
+                            deprecated: true,
                             description: "Indicates whether a person at the thermostat can change the thermostat's settings.",
-                            type: "boolean"
+                            type: "boolean",
+                            "x-deprecated": "Use 'thermostat_schedule.is_override_allowed'"
                           },
                           name: {
                             default: null,
@@ -7711,19 +7727,40 @@ var openapi_default = {
         type: "object"
       },
       enrollment_automation: {
+        description: "Represents an [enrollment automation](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/issuing-mobile-credentials-from-an-access-control-system) within the [Seam mobile access solution](https://docs.seam.co/latest/capability-guides/mobile-access-in-development).",
         properties: {
-          created_at: { format: "date-time", type: "string" },
-          credential_manager_acs_system_id: { format: "uuid", type: "string" },
-          enrollment_automation_id: { format: "uuid", type: "string" },
-          user_identity_id: { format: "uuid", type: "string" },
-          workspace_id: { format: "uuid", type: "string" }
+          created_at: {
+            description: "Date and time at which the enrollment automation was created.",
+            format: "date-time",
+            type: "string"
+          },
+          credential_manager_acs_system_id: {
+            description: "ID of the associated [ACS system](https://docs.seam.co/latest/capability-guides/access-systems) that serves as the credential manager.",
+            format: "uuid",
+            type: "string"
+          },
+          enrollment_automation_id: {
+            description: "ID of the enrollment automation.",
+            format: "uuid",
+            type: "string"
+          },
+          user_identity_id: {
+            description: "ID of the associated [user identity](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity).",
+            format: "uuid",
+            type: "string"
+          },
+          workspace_id: {
+            description: "ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the enrollment automation.",
+            format: "uuid",
+            type: "string"
+          }
         },
         required: [
+          "enrollment_automation_id",
           "credential_manager_acs_system_id",
           "user_identity_id",
           "created_at",
-          "workspace_id",
-          "enrollment_automation_id"
+          "workspace_id"
         ],
         type: "object"
       },
@@ -8445,15 +8482,42 @@ var openapi_default = {
         type: "object"
       },
       user_identity: {
+        description: "Represents a [user identity](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) associated with an application user account.",
         properties: {
-          created_at: { format: "date-time", type: "string" },
+          created_at: {
+            description: "Date and time at which the user identity was created.",
+            format: "date-time",
+            type: "string"
+          },
           display_name: { minLength: 1, type: "string" },
-          email_address: { format: "email", nullable: true, type: "string" },
+          email_address: {
+            description: "Unique email address for the user identity.",
+            format: "email",
+            nullable: true,
+            type: "string"
+          },
           full_name: { minLength: 1, nullable: true, type: "string" },
-          phone_number: { nullable: true, type: "string" },
-          user_identity_id: { format: "uuid", type: "string" },
-          user_identity_key: { minLength: 1, nullable: true, type: "string" },
-          workspace_id: { format: "uuid", type: "string" }
+          phone_number: {
+            description: "Unique phone number for the user identity in [E.164 format](https://www.itu.int/rec/T-REC-E.164/en) (for example, +15555550100).",
+            nullable: true,
+            type: "string"
+          },
+          user_identity_id: {
+            description: "ID of the user identity.",
+            format: "uuid",
+            type: "string"
+          },
+          user_identity_key: {
+            description: "Unique key for the user identity.",
+            minLength: 1,
+            nullable: true,
+            type: "string"
+          },
+          workspace_id: {
+            description: "ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the user identity.",
+            format: "uuid",
+            type: "string"
+          }
         },
         required: [
           "user_identity_id",
@@ -18150,10 +18214,7 @@ var openapi_default = {
                     enum: ["off", "heat", "cool", "heat_cool"],
                     type: "string"
                   },
-                  manual_override_allowed: {
-                    description: "Indicates whether a person at the thermostat can change the thermostat's settings.",
-                    type: "boolean"
-                  },
+                  manual_override_allowed: { default: true, type: "boolean" },
                   name: {
                     default: null,
                     description: "User-friendly name to identify the climate preset.",
@@ -18161,11 +18222,7 @@ var openapi_default = {
                     type: "string"
                   }
                 },
-                required: [
-                  "device_id",
-                  "climate_preset_key",
-                  "manual_override_allowed"
-                ],
+                required: ["device_id", "climate_preset_key"],
                 type: "object"
               }
             }
@@ -19553,8 +19610,10 @@ var openapi_default = {
                     type: "string"
                   },
                   manual_override_allowed: {
+                    deprecated: true,
                     description: "Indicates whether a person at the thermostat can change the thermostat's settings.",
-                    type: "boolean"
+                    type: "boolean",
+                    "x-deprecated": "Use 'thermostat_schedule.is_override_allowed'"
                   },
                   name: {
                     default: null,
@@ -19648,8 +19707,10 @@ var openapi_default = {
                     type: "string"
                   },
                   manual_override_allowed: {
+                    deprecated: true,
                     description: "Indicates whether a person at the thermostat can change the thermostat's settings.",
-                    type: "boolean"
+                    type: "boolean",
+                    "x-deprecated": "Use 'thermostat_schedule.is_override_allowed'"
                   },
                   name: {
                     default: null,
@@ -19699,14 +19760,23 @@ var openapi_default = {
     },
     "/user_identities/add_acs_user": {
       post: {
+        description: "Adds a specified [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) to a specified [user identity](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity).",
         operationId: "userIdentitiesAddAcsUserPost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  acs_user_id: { format: "uuid", type: "string" },
-                  user_identity_id: { format: "uuid", type: "string" }
+                  acs_user_id: {
+                    description: "ID of the desired ACS user.",
+                    format: "uuid",
+                    type: "string"
+                  },
+                  user_identity_id: {
+                    description: "ID of the desired user identity.",
+                    format: "uuid",
+                    type: "string"
+                  }
                 },
                 required: ["user_identity_id", "acs_user_id"],
                 type: "object"
@@ -19739,17 +19809,27 @@ var openapi_default = {
         tags: ["/user_identities"],
         "x-fern-sdk-group-name": ["user_identities"],
         "x-fern-sdk-method-name": "add_acs_user",
-        "x-response-key": null
+        "x-response-key": null,
+        "x-title": "Add an ACS User to a User Identity"
       },
       put: {
+        description: "Adds a specified [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) to a specified [user identity](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity).",
         operationId: "userIdentitiesAddAcsUserPut",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  acs_user_id: { format: "uuid", type: "string" },
-                  user_identity_id: { format: "uuid", type: "string" }
+                  acs_user_id: {
+                    description: "ID of the desired ACS user.",
+                    format: "uuid",
+                    type: "string"
+                  },
+                  user_identity_id: {
+                    description: "ID of the desired user identity.",
+                    format: "uuid",
+                    type: "string"
+                  }
                 },
                 required: ["user_identity_id", "acs_user_id"],
                 type: "object"
@@ -19781,11 +19861,13 @@ var openapi_default = {
         summary: "/user_identities/add_acs_user",
         tags: ["/user_identities"],
         "x-fern-ignore": true,
-        "x-response-key": null
+        "x-response-key": null,
+        "x-title": "Add an ACS User to a User Identity"
       }
     },
     "/user_identities/create": {
       post: {
+        description: "Creates a new [user identity](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity).",
         operationId: "userIdentitiesCreatePost",
         requestBody: {
           content: {
@@ -19793,13 +19875,24 @@ var openapi_default = {
               schema: {
                 properties: {
                   email_address: {
+                    description: "Unique email address for the user identity.",
                     format: "email",
                     nullable: true,
                     type: "string"
                   },
-                  full_name: { minLength: 1, nullable: true, type: "string" },
-                  phone_number: { nullable: true, type: "string" },
+                  full_name: {
+                    description: "Full name of the user associated with the user identity.",
+                    minLength: 1,
+                    nullable: true,
+                    type: "string"
+                  },
+                  phone_number: {
+                    description: "Unique phone number for the user identity in E.164 format (for example, +15555550100).",
+                    nullable: true,
+                    type: "string"
+                  },
                   user_identity_key: {
+                    description: "Unique key for the user identity.",
                     minLength: 1,
                     nullable: true,
                     type: "string"
@@ -19841,18 +19934,24 @@ var openapi_default = {
         "x-fern-sdk-group-name": ["user_identities"],
         "x-fern-sdk-method-name": "create",
         "x-fern-sdk-return-value": "user_identity",
-        "x-response-key": "user_identity"
+        "x-response-key": "user_identity",
+        "x-title": "Create a User Identity"
       }
     },
     "/user_identities/delete": {
       post: {
+        description: "Deletes a specified [user identity](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity). To delete a user identity, you must first delete any [ACS credentials](https://docs.seam.co/latest/api/access-control-systems/credentials) and [enrollment automations](https://docs.seam.co/latest/api/user_identities/enrollment_automations/delete) associated with the user identity. You must also deactivate any associated phones.",
         operationId: "userIdentitiesDeletePost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  user_identity_id: { format: "uuid", type: "string" }
+                  user_identity_id: {
+                    description: "ID of the desired user identity.",
+                    format: "uuid",
+                    type: "string"
+                  }
                 },
                 required: ["user_identity_id"],
                 type: "object"
@@ -19885,18 +19984,24 @@ var openapi_default = {
         tags: ["/user_identities"],
         "x-fern-sdk-group-name": ["user_identities"],
         "x-fern-sdk-method-name": "delete",
-        "x-response-key": null
+        "x-response-key": null,
+        "x-title": "Delete a User Identity"
       }
     },
     "/user_identities/enrollment_automations/delete": {
       post: {
+        description: "Deletes a specified [enrollment automation](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/issuing-mobile-credentials-from-an-access-control-system). You must delete all enrollment automations associated with a [user identity](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) before [deleting the user identity](https://docs.seam.co/latest/api/user_identities/delete).",
         operationId: "userIdentitiesEnrollmentAutomationsDeletePost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  enrollment_automation_id: { format: "uuid", type: "string" }
+                  enrollment_automation_id: {
+                    description: "ID of the desired enrollment automation.",
+                    format: "uuid",
+                    type: "string"
+                  }
                 },
                 required: ["enrollment_automation_id"],
                 type: "object"
@@ -19929,18 +20034,24 @@ var openapi_default = {
         tags: ["/user_identities"],
         "x-fern-sdk-group-name": ["user_identities", "enrollment_automations"],
         "x-fern-sdk-method-name": "delete",
-        "x-response-key": null
+        "x-response-key": null,
+        "x-title": "Delete an Enrollment Automation"
       }
     },
     "/user_identities/enrollment_automations/get": {
       post: {
+        description: "Returns a specified [enrollment automation](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/issuing-mobile-credentials-from-an-access-control-system).",
         operationId: "userIdentitiesEnrollmentAutomationsGetPost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  enrollment_automation_id: { format: "uuid", type: "string" }
+                  enrollment_automation_id: {
+                    description: "ID of the desired enrollment automation.",
+                    format: "uuid",
+                    type: "string"
+                  }
                 },
                 required: ["enrollment_automation_id"],
                 type: "object"
@@ -19980,28 +20091,43 @@ var openapi_default = {
         "x-fern-sdk-group-name": ["user_identities", "enrollment_automations"],
         "x-fern-sdk-method-name": "get",
         "x-fern-sdk-return-value": "enrollment_automation",
-        "x-response-key": "enrollment_automation"
+        "x-response-key": "enrollment_automation",
+        "x-title": "Get an Enrollment Automation"
       }
     },
     "/user_identities/enrollment_automations/launch": {
       post: {
+        description: "Sets up a new [enrollment automation](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/issuing-mobile-credentials-from-an-access-control-system) for a specified [user identity](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) with a specified [credential manager](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/issuing-mobile-credentials-from-an-access-control-system).",
         operationId: "userIdentitiesEnrollmentAutomationsLaunchPost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  acs_credential_pool_id: { format: "uuid", type: "string" },
-                  create_credential_manager_user: { type: "boolean" },
+                  acs_credential_pool_id: {
+                    description: "ID of the ACS credential pool from which to obtain credentials for the user identity.",
+                    format: "uuid",
+                    type: "string"
+                  },
+                  create_credential_manager_user: {
+                    description: "Indicates whether to create an associated credential manager user. If you set `create_credential_manager_user` to `true`, you cannot specify a `credential_manager_acs_user_id`.",
+                    type: "boolean"
+                  },
                   credential_manager_acs_system_id: {
+                    description: "ID of the desired ACS system that serves as the credential manager.",
                     format: "uuid",
                     type: "string"
                   },
                   credential_manager_acs_user_id: {
+                    description: "ID of the associated ACS user within the credential manager. If you specify a `credential_manager_acs_user_id`, you cannot set `create_credential_manager_user` to `true`.",
                     format: "uuid",
                     type: "string"
                   },
-                  user_identity_id: { format: "uuid", type: "string" }
+                  user_identity_id: {
+                    description: "ID of the desired user identity.",
+                    format: "uuid",
+                    type: "string"
+                  }
                 },
                 required: [
                   "user_identity_id",
@@ -20068,18 +20194,24 @@ var openapi_default = {
         "x-fern-sdk-group-name": ["user_identities", "enrollment_automations"],
         "x-fern-sdk-method-name": "launch",
         "x-fern-sdk-return-value": "enrollment_automation",
-        "x-response-key": "enrollment_automation"
+        "x-response-key": "enrollment_automation",
+        "x-title": "Launch an Enrollment Automation"
       }
     },
     "/user_identities/enrollment_automations/list": {
       post: {
+        description: "Returns a list of all [enrollment automations](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/issuing-mobile-credentials-from-an-access-control-system) for a specified [user identity](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity).",
         operationId: "userIdentitiesEnrollmentAutomationsListPost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  user_identity_id: { format: "uuid", type: "string" }
+                  user_identity_id: {
+                    description: "ID of the user identity for which you want to retrieve all enrollment automations.",
+                    format: "uuid",
+                    type: "string"
+                  }
                 },
                 required: ["user_identity_id"],
                 type: "object"
@@ -20122,11 +20254,13 @@ var openapi_default = {
         "x-fern-sdk-group-name": ["user_identities", "enrollment_automations"],
         "x-fern-sdk-method-name": "list",
         "x-fern-sdk-return-value": "enrollment_automations",
-        "x-response-key": "enrollment_automations"
+        "x-response-key": "enrollment_automations",
+        "x-title": "List Enrollment Automations"
       }
     },
     "/user_identities/get": {
       post: {
+        description: "Returns a specified [user identity](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity).",
         operationId: "userIdentitiesGetPost",
         requestBody: {
           content: {
@@ -20135,7 +20269,11 @@ var openapi_default = {
                 oneOf: [
                   {
                     properties: {
-                      user_identity_id: { format: "uuid", type: "string" }
+                      user_identity_id: {
+                        description: "ID of the desired user identity.",
+                        format: "uuid",
+                        type: "string"
+                      }
                     },
                     required: ["user_identity_id"],
                     type: "object"
@@ -20181,19 +20319,29 @@ var openapi_default = {
         "x-fern-sdk-group-name": ["user_identities"],
         "x-fern-sdk-method-name": "get",
         "x-fern-sdk-return-value": "user_identity",
-        "x-response-key": "user_identity"
+        "x-response-key": "user_identity",
+        "x-title": "Get a User Identity"
       }
     },
     "/user_identities/grant_access_to_device": {
       post: {
+        description: "Grants a specified [user identity](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) access to a specified [device](https://docs.seam.co/latest/core-concepts/devices/).",
         operationId: "userIdentitiesGrantAccessToDevicePost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  device_id: { format: "uuid", type: "string" },
-                  user_identity_id: { format: "uuid", type: "string" }
+                  device_id: {
+                    description: "ID of the desired managed device.",
+                    format: "uuid",
+                    type: "string"
+                  },
+                  user_identity_id: {
+                    description: "ID of the desired user identity.",
+                    format: "uuid",
+                    type: "string"
+                  }
                 },
                 required: ["user_identity_id", "device_id"],
                 type: "object"
@@ -20226,17 +20374,27 @@ var openapi_default = {
         tags: ["/user_identities"],
         "x-fern-sdk-group-name": ["user_identities"],
         "x-fern-sdk-method-name": "grant_access_to_device",
-        "x-response-key": null
+        "x-response-key": null,
+        "x-title": "Grant a User Identity Access to a Device"
       },
       put: {
+        description: "Grants a specified [user identity](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) access to a specified [device](https://docs.seam.co/latest/core-concepts/devices/).",
         operationId: "userIdentitiesGrantAccessToDevicePut",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  device_id: { format: "uuid", type: "string" },
-                  user_identity_id: { format: "uuid", type: "string" }
+                  device_id: {
+                    description: "ID of the desired managed device.",
+                    format: "uuid",
+                    type: "string"
+                  },
+                  user_identity_id: {
+                    description: "ID of the desired user identity.",
+                    format: "uuid",
+                    type: "string"
+                  }
                 },
                 required: ["user_identity_id", "device_id"],
                 type: "object"
@@ -20268,11 +20426,13 @@ var openapi_default = {
         summary: "/user_identities/grant_access_to_device",
         tags: ["/user_identities"],
         "x-fern-ignore": true,
-        "x-response-key": null
+        "x-response-key": null,
+        "x-title": "Grant a User Identity Access to a Device"
       }
     },
     "/user_identities/list": {
       post: {
+        description: "Returns a list of all [user identities](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity).",
         operationId: "userIdentitiesListPost",
         requestBody: {
           content: {
@@ -20322,18 +20482,24 @@ var openapi_default = {
         "x-fern-sdk-group-name": ["user_identities"],
         "x-fern-sdk-method-name": "list",
         "x-fern-sdk-return-value": "user_identities",
-        "x-response-key": "user_identities"
+        "x-response-key": "user_identities",
+        "x-title": "List User Identities"
       }
     },
     "/user_identities/list_accessible_devices": {
       post: {
+        description: "Returns a list of all [devices](https://docs.seam.co/latest/core-concepts/devices) associated with a specified [user identity](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity).",
         operationId: "userIdentitiesListAccessibleDevicesPost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  user_identity_id: { format: "uuid", type: "string" }
+                  user_identity_id: {
+                    description: "ID of the user identity for which you want to retrieve all accessible devices.",
+                    format: "uuid",
+                    type: "string"
+                  }
                 },
                 required: ["user_identity_id"],
                 type: "object"
@@ -20379,18 +20545,24 @@ var openapi_default = {
         "x-fern-sdk-group-name": ["user_identities"],
         "x-fern-sdk-method-name": "list_accessible_devices",
         "x-fern-sdk-return-value": "devices",
-        "x-response-key": "devices"
+        "x-response-key": "devices",
+        "x-title": "List Accessible Devices for a User Identity"
       }
     },
     "/user_identities/list_acs_systems": {
       post: {
+        description: "Returns a list of all [access control systems](https://docs.seam.co/latest/capability-guides/access-systems) associated with a specified [user identity](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity).",
         operationId: "userIdentitiesListAcsSystemsPost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  user_identity_id: { format: "uuid", type: "string" }
+                  user_identity_id: {
+                    description: "ID of the user identity for which you want to retrieve all access control systems.",
+                    format: "uuid",
+                    type: "string"
+                  }
                 },
                 required: ["user_identity_id"],
                 type: "object"
@@ -20431,18 +20603,24 @@ var openapi_default = {
         "x-fern-sdk-group-name": ["user_identities"],
         "x-fern-sdk-method-name": "list_acs_systems",
         "x-fern-sdk-return-value": "acs_systems",
-        "x-response-key": "acs_systems"
+        "x-response-key": "acs_systems",
+        "x-title": "List ACS Systems Associated with a User Identity"
       }
     },
     "/user_identities/list_acs_users": {
       post: {
+        description: "Returns a list of all [ACS users](https://docs.seam.co/latest/capability-guides/access-systems/user-management) assigned to a specified [user identity](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity).",
         operationId: "userIdentitiesListAcsUsersPost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  user_identity_id: { format: "uuid", type: "string" }
+                  user_identity_id: {
+                    description: "ID of the user identity for which you want to retrieve all ACS users.",
+                    format: "uuid",
+                    type: "string"
+                  }
                 },
                 required: ["user_identity_id"],
                 type: "object"
@@ -20482,19 +20660,29 @@ var openapi_default = {
         "x-fern-sdk-group-name": ["user_identities"],
         "x-fern-sdk-method-name": "list_acs_users",
         "x-fern-sdk-return-value": "acs_users",
-        "x-response-key": "acs_users"
+        "x-response-key": "acs_users",
+        "x-title": "List ACS Users Associated with a User Identity"
       }
     },
     "/user_identities/remove_acs_user": {
       post: {
+        description: "Removes a specified [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) from a specified [user identity](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity).",
         operationId: "userIdentitiesRemoveAcsUserPost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  acs_user_id: { format: "uuid", type: "string" },
-                  user_identity_id: { format: "uuid", type: "string" }
+                  acs_user_id: {
+                    description: "ID of the ACS user.",
+                    format: "uuid",
+                    type: "string"
+                  },
+                  user_identity_id: {
+                    description: "ID of the desired user identity.",
+                    format: "uuid",
+                    type: "string"
+                  }
                 },
                 required: ["user_identity_id", "acs_user_id"],
                 type: "object"
@@ -20527,19 +20715,29 @@ var openapi_default = {
         tags: ["/user_identities"],
         "x-fern-sdk-group-name": ["user_identities"],
         "x-fern-sdk-method-name": "remove_acs_user",
-        "x-response-key": null
+        "x-response-key": null,
+        "x-title": "Remove an ACS User from a User Identity"
       }
     },
     "/user_identities/revoke_access_to_device": {
       post: {
+        description: "Revokes access to a specified [device](https://docs.seam.co/latest/core-concepts/devices/) from a specified [user identity](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity).",
         operationId: "userIdentitiesRevokeAccessToDevicePost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
-                  device_id: { format: "uuid", type: "string" },
-                  user_identity_id: { format: "uuid", type: "string" }
+                  device_id: {
+                    description: "ID of the desired managed device.",
+                    format: "uuid",
+                    type: "string"
+                  },
+                  user_identity_id: {
+                    description: "ID of the desired user identity.",
+                    format: "uuid",
+                    type: "string"
+                  }
                 },
                 required: ["user_identity_id", "device_id"],
                 type: "object"
@@ -20572,7 +20770,8 @@ var openapi_default = {
         tags: ["/user_identities"],
         "x-fern-sdk-group-name": ["user_identities"],
         "x-fern-sdk-method-name": "revoke_access_to_device",
-        "x-response-key": null
+        "x-response-key": null,
+        "x-title": "Revoke Access to a Device from a User Identity"
       }
     },
     "/user_identities/update": {
@@ -20584,14 +20783,24 @@ var openapi_default = {
               schema: {
                 properties: {
                   email_address: {
+                    description: "Unique email address for the user identity.",
                     format: "email",
                     nullable: true,
                     type: "string"
                   },
                   full_name: { minLength: 1, nullable: true, type: "string" },
-                  phone_number: { nullable: true, type: "string" },
-                  user_identity_id: { format: "uuid", type: "string" },
+                  phone_number: {
+                    description: "Unique phone number for the user identity in [E.164 format](https://www.itu.int/rec/T-REC-E.164/en) (for example, +15555550100).",
+                    nullable: true,
+                    type: "string"
+                  },
+                  user_identity_id: {
+                    description: "ID of the user identity.",
+                    format: "uuid",
+                    type: "string"
+                  },
                   user_identity_key: {
+                    description: "Unique key for the user identity.",
                     minLength: 1,
                     nullable: true,
                     type: "string"
@@ -20637,14 +20846,24 @@ var openapi_default = {
               schema: {
                 properties: {
                   email_address: {
+                    description: "Unique email address for the user identity.",
                     format: "email",
                     nullable: true,
                     type: "string"
                   },
                   full_name: { minLength: 1, nullable: true, type: "string" },
-                  phone_number: { nullable: true, type: "string" },
-                  user_identity_id: { format: "uuid", type: "string" },
+                  phone_number: {
+                    description: "Unique phone number for the user identity in [E.164 format](https://www.itu.int/rec/T-REC-E.164/en) (for example, +15555550100).",
+                    nullable: true,
+                    type: "string"
+                  },
+                  user_identity_id: {
+                    description: "ID of the user identity.",
+                    format: "uuid",
+                    type: "string"
+                  },
                   user_identity_key: {
+                    description: "Unique key for the user identity.",
                     minLength: 1,
                     nullable: true,
                     type: "string"