@seamapi/types 1.410.1 → 1.411.0

package/src/lib/seam/connect/openapi.ts

@@ -15970,7 +15970,12 @@ export default {
       magic_link: {
         properties: {
           building_block_type: {
-            enum: ['connect_accounts', 'manage_devices', 'organize_spaces'],
+            enum: [
+              'connect_accounts',
+              'manage_devices',
+              'organize_spaces',
+              'console',
+            ],
             type: 'string',
           },
           created_at: { format: 'date-time', type: 'string' },
@@ -22253,6 +22258,7 @@ export default {
         },
         security: [
           { client_session: [] },
+          { client_session_with_customer: [] },
           { pat_with_workspace: [] },
           { console_session_with_workspace: [] },
           { api_key: [] },
@@ -22401,6 +22407,7 @@ export default {
         },
         security: [
           { client_session: [] },
+          { client_session_with_customer: [] },
           { pat_with_workspace: [] },
           { console_session_with_workspace: [] },
           { api_key: [] },
@@ -22550,6 +22557,7 @@ export default {
         },
         security: [
           { client_session: [] },
+          { client_session_with_customer: [] },
           { pat_with_workspace: [] },
           { console_session_with_workspace: [] },
           { api_key: [] },
@@ -29136,6 +29144,7 @@ export default {
         },
         security: [
           { client_session: [] },
+          { client_session_with_customer: [] },
           { api_key: [] },
           { pat_with_workspace: [] },
           { console_session_with_workspace: [] },
@@ -29926,6 +29935,7 @@ export default {
           { api_key: [] },
           { pat_with_workspace: [] },
           { console_session_with_workspace: [] },
+          { client_session_with_customer: [] },
         ],
         summary: '/devices/simulate/connect',
         tags: ['/devices'],
@@ -29978,6 +29988,7 @@ export default {
           { api_key: [] },
           { pat_with_workspace: [] },
           { console_session_with_workspace: [] },
+          { client_session_with_customer: [] },
         ],
         summary: '/devices/simulate/disconnect',
         tags: ['/devices'],
@@ -30030,6 +30041,7 @@ export default {
           { api_key: [] },
           { pat_with_workspace: [] },
           { console_session_with_workspace: [] },
+          { client_session_with_customer: [] },
         ],
         summary: '/devices/simulate/remove',
         tags: ['/devices'],
@@ -30629,6 +30641,7 @@ export default {
           { pat_with_workspace: [] },
           { console_session_with_workspace: [] },
           { client_session: [] },
+          { client_session_with_customer: [] },
         ],
         summary: '/devices/update',
         tags: ['/devices'],
@@ -30711,6 +30724,7 @@ export default {
           { pat_with_workspace: [] },
           { console_session_with_workspace: [] },
           { client_session: [] },
+          { client_session_with_customer: [] },
         ],
         summary: '/devices/update',
         tags: ['/devices'],
@@ -30777,6 +30791,7 @@ export default {
           { api_key: [] },
           { pat_with_workspace: [] },
           { console_session_with_workspace: [] },
+          { client_session_with_customer: [] },
         ],
         summary: '/events/get',
         tags: ['/events'],
@@ -32661,7 +32676,8 @@ export default {
               schema: {
                 properties: {
                   device_id: {
-                    description: 'Device ID of the desired phone.',
+                    description:
+                      'Device ID of the phone that you want to deactivate.',
                     type: 'string',
                   },
                 },
@@ -32704,7 +32720,7 @@ export default {
     '/phones/get': {
       post: {
         description:
-          'Returns a single phone entry matching the provided `device_id`.',
+          'Returns a specified [phone](https://docs.seam.co/latest/capability-guides/mobile-access/managing-phones-for-a-user-identity).',
         operationId: 'phonesGetPost',
         requestBody: {
           content: {
@@ -32712,7 +32728,7 @@ export default {
               schema: {
                 properties: {
                   device_id: {
-                    description: 'Device ID of the desired phone.',
+                    description: 'Device ID of the phone that you want to get.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -32753,13 +32769,13 @@ export default {
         'x-fern-sdk-method-name': 'get',
         'x-fern-sdk-return-value': 'phone',
         'x-response-key': 'phone',
-        'x-title': 'Get Phone',
+        'x-title': 'Get a Phone',
       },
     },
     '/phones/list': {
       post: {
         description:
-          'Returns a list of all phones. To filter the list of returned phones by a specific owner user identity or credential, include the `owner_user_identity_id` or `acs_credential_id`, respectively, in the request body.',
+          'Returns a list of all [phones](https://docs.seam.co/latest/capability-guides/mobile-access/managing-phones-for-a-user-identity). To filter the list of returned phones by a specific owner user identity or credential, include the `owner_user_identity_id` or `acs_credential_id`, respectively, in the request body.',
         operationId: 'phonesListPost',
         requestBody: {
           content: {
@@ -32768,13 +32784,13 @@ export default {
                 properties: {
                   acs_credential_id: {
                     description:
-                      'ID of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) by which to filter the list of returned phones.',
+                      'ID of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) by which you want to filter the list of returned phones.',
                     format: 'uuid',
                     type: 'string',
                   },
                   owner_user_identity_id: {
                     description:
-                      'ID of the user identity that represents the owner by which to filter the list of returned phones.',
+                      'ID of the user identity that represents the owner by which you want to filter the list of returned phones.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -32823,7 +32839,7 @@ export default {
     '/phones/simulate/create_sandbox_phone': {
       post: {
         description:
-          'Creates a new simulated phone in a [sandbox workspace](https://docs.seam.co/latest/core-concepts/workspaces#sandbox-workspaces). For more information, see [Creating a Simulated Phone for a User Identity](https://docs.seam.co/latest/capability-guides/mobile-access/developing-in-a-sandbox-workspace#creating-a-simulated-phone-for-a-user-identity).',
+          'Creates a new simulated phone in a [sandbox workspace](https://docs.seam.co/latest/core-concepts/workspaces#sandbox-workspaces). See also [Creating a Simulated Phone for a User Identity](https://docs.seam.co/latest/capability-guides/mobile-access/developing-in-a-sandbox-workspace#creating-a-simulated-phone-for-a-user-identity).',
         operationId: 'phonesSimulateCreateSandboxPhonePost',
         requestBody: {
           content: {
@@ -32833,7 +32849,7 @@ export default {
                   assa_abloy_metadata: {
                     default: {},
                     description:
-                      'ASSA ABLOY metadata to associate with the simulated phone.',
+                      'ASSA ABLOY metadata that you want to associate with the simulated phone.',
                     properties: {
                       application_version: {
                         default: '1.0.0',
@@ -32877,13 +32893,13 @@ export default {
                   },
                   custom_sdk_installation_id: {
                     description:
-                      'ID of the custom SDK installation to use for the simulated phone.',
+                      'ID of the custom SDK installation that you want to use for the simulated phone.',
                     type: 'string',
                   },
                   phone_metadata: {
                     default: {},
                     description:
-                      'Metadata to associate with the simulated phone.',
+                      'Metadata that you want to associate with the simulated phone.',
                     properties: {
                       device_manufacturer: {
                         default: 'Samsung',
@@ -32915,7 +32931,7 @@ export default {
                   },
                   user_identity_id: {
                     description:
-                      'ID of the user identity to associate with the simulated phone.',
+                      'ID of the user identity that you want to associate with the simulated phone.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -32961,16 +32977,29 @@ export default {
     },
     '/seam/bridge/v1/bridge_client_sessions/create': {
       post: {
-        description: 'Creates a new bridge client session.',
+        description:
+          'Creates a new [Seam Bridge](https://docs.seam.co/latest/capability-guides/seam-bridge) client session.',
         operationId: 'seamBridgeV1BridgeClientSessionsCreatePost',
         requestBody: {
           content: {
             'application/json': {
               schema: {
                 properties: {
-                  bridge_client_machine_identifier_key: { type: 'string' },
-                  bridge_client_name: { type: 'string' },
-                  bridge_client_time_zone: { type: 'string' },
+                  bridge_client_machine_identifier_key: {
+                    description:
+                      'Identifier key of the client machine for the Seam Bridge client that you want to create.',
+                    type: 'string',
+                  },
+                  bridge_client_name: {
+                    description:
+                      'Name of the Seam Bridge client that you want to create.',
+                    type: 'string',
+                  },
+                  bridge_client_time_zone: {
+                    description:
+                      'Time zone for the Seam Bridge that you want to create.',
+                    type: 'string',
+                  },
                 },
                 required: [
                   'bridge_client_name',
@@ -33156,13 +33185,13 @@ export default {
         'x-fern-sdk-return-value': 'bridge_client_session',
         'x-response-key': 'bridge_client_session',
         'x-title': 'Create a Bridge Client Session',
-        'x-undocumented': 'Seam Bridge Client only.',
+        'x-undocumented': 'Seam Bridge client only.',
       },
     },
     '/seam/bridge/v1/bridge_client_sessions/get': {
       get: {
         description:
-          'Returns the bridge client session associated with the session token used.',
+          'Returns the [Seam Bridge](https://docs.seam.co/latest/capability-guides/seam-bridge) client session associated with the client session token used for authentication.',
         operationId: 'seamBridgeV1BridgeClientSessionsGetGet',
         responses: {
           200: {
@@ -33330,12 +33359,12 @@ export default {
         tags: [],
         'x-fern-ignore': true,
         'x-response-key': 'bridge_client_session',
-        'x-title': 'Get a Bridge Client Session',
+        'x-title': 'Get a Seam Bridge Client Session',
         'x-undocumented': 'Seam Bridge Client only.',
       },
       post: {
         description:
-          'Returns the bridge client session associated with the session token used.',
+          'Returns the [Seam Bridge](https://docs.seam.co/latest/capability-guides/seam-bridge) client session associated with the client session token used for authentication.',
         operationId: 'seamBridgeV1BridgeClientSessionsGetPost',
         responses: {
           200: {
@@ -33510,14 +33539,14 @@ export default {
         'x-fern-sdk-method-name': 'get',
         'x-fern-sdk-return-value': 'bridge_client_session',
         'x-response-key': 'bridge_client_session',
-        'x-title': 'Get a Bridge Client Session',
+        'x-title': 'Get a Seam Bridge Client Session',
         'x-undocumented': 'Seam Bridge Client only.',
       },
     },
     '/seam/bridge/v1/bridge_client_sessions/refresh_telemetry_token': {
       post: {
         description:
-          'Returns the bridge client session associated with the session token and refreshed telemetry token.',
+          'Returns the [Seam Bridge](https://docs.seam.co/latest/capability-guides/seam-bridge) client session associated with the client session token used for authentication and refreshed telemetry token.',
         operationId:
           'seamBridgeV1BridgeClientSessionsRefreshTelemetryTokenPost',
         responses: {
@@ -33694,14 +33723,15 @@ export default {
         'x-fern-sdk-method-name': 'refresh_telemetry_token',
         'x-fern-sdk-return-value': 'bridge_client_session',
         'x-response-key': 'bridge_client_session',
-        'x-title': 'Refresh telemetry token for bridge client session',
+        'x-title':
+          'Refresh the Telemetry Token for a Seam Bridge Client Session',
         'x-undocumented': 'Seam Bridge Client only.',
       },
     },
     '/seam/bridge/v1/bridge_client_sessions/regenerate_pairing_code': {
       post: {
         description:
-          'Generate a new pairing code and return the updated bridge client session.',
+          'Generate a new pairing code and return the updated [Seam Bridge](https://docs.seam.co/latest/capability-guides/seam-bridge) client session.',
         operationId:
           'seamBridgeV1BridgeClientSessionsRegeneratePairingCodePost',
         responses: {
@@ -33878,21 +33908,30 @@ export default {
         'x-fern-sdk-method-name': 'regenerate_pairing_code',
         'x-fern-sdk-return-value': 'bridge_client_session',
         'x-response-key': 'bridge_client_session',
-        'x-title': 'Regenerate a Bridge Client Session Pairing Code',
+        'x-title': 'Regenerate a Seam Bridge Client Session Pairing Code',
         'x-undocumented': 'Seam Bridge Client only.',
       },
     },
     '/seam/bridge/v1/bridge_client_sessions/report_status': {
       post: {
-        description: "Report a Seam Bridge Bridge client's status.",
+        description:
+          'Report the status of a [Seam Bridge](https://docs.seam.co/latest/capability-guides/seam-bridge) client.',
         operationId: 'seamBridgeV1BridgeClientSessionsReportStatusPost',
         requestBody: {
           content: {
             'application/json': {
               schema: {
                 properties: {
-                  is_tailscale_connected: { nullable: true, type: 'boolean' },
-                  tailscale_ip_v4: { nullable: true, type: 'string' },
+                  is_tailscale_connected: {
+                    description: 'Indicates whether Tailscale is connected.',
+                    nullable: true,
+                    type: 'boolean',
+                  },
+                  tailscale_ip_v4: {
+                    description: 'Tailscale IPv4 address.',
+                    nullable: true,
+                    type: 'string',
+                  },
                 },
                 required: ['is_tailscale_connected', 'tailscale_ip_v4'],
                 type: 'object',
@@ -33927,14 +33966,14 @@ export default {
         ],
         'x-fern-sdk-method-name': 'report_status',
         'x-response-key': null,
-        'x-title': "Report a Bridge Client's Status",
+        'x-title': 'Report the Status of a Seam Bridge Client',
         'x-undocumented': 'Seam Bridge Client only.',
       },
     },
     '/seam/bridge/v1/bridge_connected_systems/list': {
       get: {
         description:
-          'Returns the bridge connected systems associated with the session token used.',
+          'Returns the [Seam Bridge](https://docs.seam.co/latest/capability-guides/seam-bridge)-connected systems associated with the client session token used for authentication.',
         operationId: 'seamBridgeV1BridgeConnectedSystemsListGet',
         responses: {
           200: {
@@ -33997,12 +34036,12 @@ export default {
         tags: [],
         'x-fern-ignore': true,
         'x-response-key': 'bridge_connected_systems',
-        'x-title': 'List Bridge Connected Systems',
+        'x-title': 'List Bridge-Connected Systems',
         'x-undocumented': 'Seam Bridge Client only.',
       },
       post: {
         description:
-          'Returns the bridge connected systems associated with the session token used.',
+          'Returns the [Seam Bridge](https://docs.seam.co/latest/capability-guides/seam-bridge)-connected systems associated with the client session token used for authentication.',
         operationId: 'seamBridgeV1BridgeConnectedSystemsListPost',
         responses: {
           200: {
@@ -34072,14 +34111,14 @@ export default {
         'x-fern-sdk-method-name': 'list',
         'x-fern-sdk-return-value': 'bridge_connected_systems',
         'x-response-key': 'bridge_connected_systems',
-        'x-title': 'List Bridge Connected Systems',
+        'x-title': 'List Bridge-Connected Systems',
         'x-undocumented': 'Seam Bridge Client only.',
       },
     },
     '/seam/instant_key/v1/client_sessions/exchange_short_code': {
       post: {
         description:
-          'Exchanges a short code for a Client Session Token (CST).\nThis endpoint is used by mobile apps to securely retrieve a client session token\nusing a short code obtained from an instant key URL.',
+          'Exchanges a short code for a client session token. Mobile apps use this endpoint to retrieve a client session token securely using a short code obtained from an Instant Key URL.',
         operationId: 'seamInstantKeyV1ClientSessionsExchangeShortCodePost',
         requestBody: {
           content: {
@@ -34088,7 +34127,7 @@ export default {
                 properties: {
                   short_code: {
                     description:
-                      'The short code to exchange for a client session token',
+                      'Short code that you want to exchange for a client session token.',
                     type: 'string',
                   },
                 },
@@ -34137,7 +34176,8 @@ export default {
     },
     '/seam/mobile_sdk/v1/acs/credentials/list': {
       post: {
-        description: 'Returns a list of all ACS credentials.',
+        description:
+          'Returns a list of all [credentials](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
         operationId: 'seamMobileSdkV1AcsCredentialsListPost',
         requestBody: {
           content: {
@@ -34185,15 +34225,21 @@ export default {
     },
     '/seam/mobile_sdk/v1/phone_sessions/get_or_create': {
       post: {
-        description: 'Get or create a session for a mobile SDK phone.',
+        description: 'Gets or creates a session for a mobile SDK phone.',
         operationId: 'seamMobileSdkV1PhoneSessionsGetOrCreatePost',
         requestBody: {
           content: {
             'application/json': {
               schema: {
                 properties: {
-                  custom_sdk_installation_id: { type: 'string' },
+                  custom_sdk_installation_id: {
+                    description:
+                      'ID of the custom SDK installation that you want to use for the new session.',
+                    type: 'string',
+                  },
                   phone_device_metadata: {
+                    description:
+                      'Phone device metadata that you want to use for the new session.',
                     properties: {
                       manufacturer: { type: 'string' },
                       model: { type: 'string' },
@@ -34201,7 +34247,12 @@ export default {
                     },
                     type: 'object',
                   },
-                  phone_os: { enum: ['ios', 'android'], type: 'string' },
+                  phone_os: {
+                    description:
+                      'Phone operating system that you want to use for the new session.',
+                    enum: ['ios', 'android'],
+                    type: 'string',
+                  },
                 },
                 required: ['custom_sdk_installation_id', 'phone_os'],
                 type: 'object',
@@ -34244,13 +34295,18 @@ export default {
     '/seam/partner/v1/building_blocks/spaces/auto_map': {
       post: {
         description:
-          'Auto map partner resources that have been pushed to Seam.',
+          'Auto-maps partner resources that have been pushed to Seam.',
         operationId: 'seamPartnerV1BuildingBlocksSpacesAutoMapPost',
         requestBody: {
           content: {
             'application/json': {
               schema: {
-                properties: { collection_key: { type: 'string' } },
+                properties: {
+                  collection_key: {
+                    description: 'Collection key.',
+                    type: 'string',
+                  },
+                },
                 required: ['collection_key'],
                 type: 'object',
               },
@@ -34331,13 +34387,13 @@ export default {
         'x-fern-sdk-method-name': 'auto_map',
         'x-fern-sdk-return-value': 'spaces',
         'x-response-key': 'spaces',
-        'x-title': 'Do auto mapping for partner resources that map to spaces',
+        'x-title': 'Do Auto-Mapping for Partner Resources that Map to Spaces',
         'x-undocumented': 'Partner building blocks/UI only.',
       },
     },
     '/seam/partner/v1/resources/list': {
       post: {
-        description: 'List partner resources that have been pushed to Seam.',
+        description: 'Lists partner resources that have been pushed to Seam.',
         operationId: 'seamPartnerV1ResourcesListPost',
         requestBody: {
           content: {
@@ -34345,7 +34401,8 @@ export default {
               schema: {
                 properties: {
                   resource_type_alias: {
-                    description: 'Filter by resource type alias.',
+                    description:
+                      'Resource type alias by which you want to filter partner resources.',
                     type: 'string',
                   },
                 },
@@ -34412,13 +34469,14 @@ export default {
         'x-fern-sdk-method-name': 'list',
         'x-fern-sdk-return-value': 'partner_resources',
         'x-response-key': 'partner_resources',
-        'x-title': 'List partner resources at Seam',
+        'x-title': 'List Partner Resources at Seam',
         'x-undocumented': 'Partner building blocks/UI only.',
       },
     },
     '/spaces/add_acs_entrances': {
       post: {
-        description: 'Add entrances to a specific space.',
+        description:
+          'Adds [entrances](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details) to a specific space.',
         operationId: 'spacesAddAcsEntrancesPost',
         requestBody: {
           content: {
@@ -34426,11 +34484,18 @@ export default {
               schema: {
                 properties: {
                   acs_entrance_ids: {
+                    description:
+                      'IDs of the entrances that you want to add to the space.',
                     items: { format: 'uuid', type: 'string' },
                     minItems: 1,
                     type: 'array',
                   },
-                  space_id: { format: 'uuid', type: 'string' },
+                  space_id: {
+                    description:
+                      'ID of the space to which you want to add entrances.',
+                    format: 'uuid',
+                    type: 'string',
+                  },
                 },
                 required: ['space_id', 'acs_entrance_ids'],
                 type: 'object',
@@ -34465,10 +34530,11 @@ export default {
         'x-fern-sdk-group-name': ['spaces'],
         'x-fern-sdk-method-name': 'add_acs_entrances',
         'x-response-key': null,
-        'x-title': 'Add ACS Entrances',
+        'x-title': 'Add Entrances to a Space',
       },
       put: {
-        description: 'Add entrances to a specific space.',
+        description:
+          'Adds [entrances](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details) to a specific space.',
         operationId: 'spacesAddAcsEntrancesPut',
         requestBody: {
           content: {
@@ -34476,11 +34542,18 @@ export default {
               schema: {
                 properties: {
                   acs_entrance_ids: {
+                    description:
+                      'IDs of the entrances that you want to add to the space.',
                     items: { format: 'uuid', type: 'string' },
                     minItems: 1,
                     type: 'array',
                   },
-                  space_id: { format: 'uuid', type: 'string' },
+                  space_id: {
+                    description:
+                      'ID of the space to which you want to add entrances.',
+                    format: 'uuid',
+                    type: 'string',
+                  },
                 },
                 required: ['space_id', 'acs_entrance_ids'],
                 type: 'object',
@@ -34514,12 +34587,12 @@ export default {
         'x-draft': 'Early access.',
         'x-fern-ignore': true,
         'x-response-key': null,
-        'x-title': 'Add ACS Entrances',
+        'x-title': 'Add Entrances to a Space',
       },
     },
     '/spaces/add_devices': {
       post: {
-        description: 'Add devices to a specific space.',
+        description: 'Adds devices to a specific space.',
         operationId: 'spacesAddDevicesPost',
         requestBody: {
           content: {
@@ -34527,11 +34600,18 @@ export default {
               schema: {
                 properties: {
                   device_ids: {
+                    description:
+                      'IDs of the devices that you want to add to the space.',
                     items: { format: 'uuid', type: 'string' },
                     minItems: 1,
                     type: 'array',
                   },
-                  space_id: { format: 'uuid', type: 'string' },
+                  space_id: {
+                    description:
+                      'ID of the space to which you want to add devices.',
+                    format: 'uuid',
+                    type: 'string',
+                  },
                 },
                 required: ['space_id', 'device_ids'],
                 type: 'object',
@@ -34566,10 +34646,10 @@ export default {
         'x-fern-sdk-group-name': ['spaces'],
         'x-fern-sdk-method-name': 'add_devices',
         'x-response-key': null,
-        'x-title': 'Add Space Devices',
+        'x-title': 'Add Devices to a Space',
       },
       put: {
-        description: 'Add devices to a specific space.',
+        description: 'Adds devices to a specific space.',
         operationId: 'spacesAddDevicesPut',
         requestBody: {
           content: {
@@ -34577,11 +34657,18 @@ export default {
               schema: {
                 properties: {
                   device_ids: {
+                    description:
+                      'IDs of the devices that you want to add to the space.',
                     items: { format: 'uuid', type: 'string' },
                     minItems: 1,
                     type: 'array',
                   },
-                  space_id: { format: 'uuid', type: 'string' },
+                  space_id: {
+                    description:
+                      'ID of the space to which you want to add devices.',
+                    format: 'uuid',
+                    type: 'string',
+                  },
                 },
                 required: ['space_id', 'device_ids'],
                 type: 'object',
@@ -34615,12 +34702,12 @@ export default {
         'x-draft': 'Early access.',
         'x-fern-ignore': true,
         'x-response-key': null,
-        'x-title': 'Add Space Devices',
+        'x-title': 'Add Devices to a Space',
       },
     },
     '/spaces/create': {
       post: {
-        description: 'Create a new space.',
+        description: 'Creates a new space.',
         operationId: 'spacesCreatePost',
         requestBody: {
           content: {
@@ -34628,14 +34715,21 @@ export default {
               schema: {
                 properties: {
                   acs_entrance_ids: {
+                    description:
+                      'IDs of the entrances that you want to add to the new space.',
                     items: { format: 'uuid', type: 'string' },
                     type: 'array',
                   },
                   device_ids: {
+                    description:
+                      'IDs of the devices that you want to add to the new space.',
                     items: { format: 'uuid', type: 'string' },
                     type: 'array',
                   },
-                  name: { type: 'string' },
+                  name: {
+                    description: 'Name of the space that you want to create.',
+                    type: 'string',
+                  },
                 },
                 required: ['name'],
                 type: 'object',
@@ -34674,18 +34768,24 @@ export default {
         'x-fern-sdk-method-name': 'create',
         'x-fern-sdk-return-value': 'space',
         'x-response-key': 'space',
-        'x-title': 'Create Space',
+        'x-title': 'Create a Space',
       },
     },
     '/spaces/delete': {
       post: {
-        description: 'Delete a space.',
+        description: 'Deletes a space.',
         operationId: 'spacesDeletePost',
         requestBody: {
           content: {
             'application/json': {
               schema: {
-                properties: { space_id: { format: 'uuid', type: 'string' } },
+                properties: {
+                  space_id: {
+                    description: 'ID of the space that you want to delete.',
+                    format: 'uuid',
+                    type: 'string',
+                  },
+                },
                 required: ['space_id'],
                 type: 'object',
               },
@@ -34715,21 +34815,28 @@ export default {
         ],
         summary: '/spaces/delete',
         tags: [],
+        'x-draft': 'Early access.',
         'x-fern-sdk-group-name': ['spaces'],
         'x-fern-sdk-method-name': 'delete',
         'x-response-key': null,
-        'x-title': 'Delete Space',
+        'x-title': 'Delete a Space',
       },
     },
     '/spaces/get': {
       post: {
-        description: 'Get a space.',
+        description: 'Gets a space.',
         operationId: 'spacesGetPost',
         requestBody: {
           content: {
             'application/json': {
               schema: {
-                properties: { space_id: { format: 'uuid', type: 'string' } },
+                properties: {
+                  space_id: {
+                    description: 'ID of the space that you want to get.',
+                    format: 'uuid',
+                    type: 'string',
+                  },
+                },
                 required: ['space_id'],
                 type: 'object',
               },
@@ -34762,11 +34869,12 @@ export default {
         ],
         summary: '/spaces/get',
         tags: [],
+        'x-draft': 'Early access.',
         'x-fern-sdk-group-name': ['spaces'],
         'x-fern-sdk-method-name': 'get',
         'x-fern-sdk-return-value': 'space',
         'x-response-key': 'space',
-        'x-title': 'Get Space',
+        'x-title': 'Get a Space',
       },
     },
     '/spaces/list': {
@@ -34849,7 +34957,8 @@ export default {
     },
     '/spaces/remove_acs_entrances': {
       post: {
-        description: 'Remove entrances from a specific space.',
+        description:
+          'Removes [entrances](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details) from a specific space.',
         operationId: 'spacesRemoveAcsEntrancesPost',
         requestBody: {
           content: {
@@ -34857,10 +34966,17 @@ export default {
               schema: {
                 properties: {
                   acs_entrance_ids: {
+                    description:
+                      'IDs of the entrances that you want to remove from the space.',
                     items: { format: 'uuid', type: 'string' },
                     type: 'array',
                   },
-                  space_id: { format: 'uuid', type: 'string' },
+                  space_id: {
+                    description:
+                      'ID of the space from which you want to remove entrances.',
+                    format: 'uuid',
+                    type: 'string',
+                  },
                 },
                 required: ['space_id', 'acs_entrance_ids'],
                 type: 'object',
@@ -34895,12 +35011,12 @@ export default {
         'x-fern-sdk-group-name': ['spaces'],
         'x-fern-sdk-method-name': 'remove_acs_entrances',
         'x-response-key': null,
-        'x-title': 'Remove ACS Entrances',
+        'x-title': 'Remove Entrances from a Space',
       },
     },
     '/spaces/remove_devices': {
       post: {
-        description: 'Remove devices from a specific space.',
+        description: 'Removes devices from a specific space.',
         operationId: 'spacesRemoveDevicesPost',
         requestBody: {
           content: {
@@ -34908,10 +35024,17 @@ export default {
               schema: {
                 properties: {
                   device_ids: {
+                    description:
+                      'IDs of the devices that you want to remove from the space.',
                     items: { format: 'uuid', type: 'string' },
                     type: 'array',
                   },
-                  space_id: { format: 'uuid', type: 'string' },
+                  space_id: {
+                    description:
+                      'ID of the space from which you want to remove devices.',
+                    format: 'uuid',
+                    type: 'string',
+                  },
                 },
                 required: ['space_id', 'device_ids'],
                 type: 'object',
@@ -34946,20 +35069,24 @@ export default {
         'x-fern-sdk-group-name': ['spaces'],
         'x-fern-sdk-method-name': 'remove_devices',
         'x-response-key': null,
-        'x-title': 'Remove Space Devices',
+        'x-title': 'Remove Devices from a Space',
       },
     },
     '/spaces/update': {
       patch: {
-        description: 'Update an existing space.',
+        description: 'Updates an existing space.',
         operationId: 'spacesUpdatePatch',
         requestBody: {
           content: {
             'application/json': {
               schema: {
                 properties: {
-                  name: { type: 'string' },
-                  space_id: { format: 'uuid', type: 'string' },
+                  name: { description: 'Name of the space.', type: 'string' },
+                  space_id: {
+                    description: 'ID of the space that you want to update.',
+                    format: 'uuid',
+                    type: 'string',
+                  },
                 },
                 required: ['space_id'],
                 type: 'object',
@@ -34996,18 +35123,22 @@ export default {
         'x-draft': 'Early access.',
         'x-fern-ignore': true,
         'x-response-key': 'space',
-        'x-title': 'Update Space',
+        'x-title': 'Update a Space',
       },
       post: {
-        description: 'Update an existing space.',
+        description: 'Updates an existing space.',
         operationId: 'spacesUpdatePost',
         requestBody: {
           content: {
             'application/json': {
               schema: {
                 properties: {
-                  name: { type: 'string' },
-                  space_id: { format: 'uuid', type: 'string' },
+                  name: { description: 'Name of the space.', type: 'string' },
+                  space_id: {
+                    description: 'ID of the space that you want to update.',
+                    format: 'uuid',
+                    type: 'string',
+                  },
                 },
                 required: ['space_id'],
                 type: 'object',
@@ -35046,7 +35177,7 @@ export default {
         'x-fern-sdk-method-name': 'update',
         'x-fern-sdk-return-value': 'space',
         'x-response-key': 'space',
-        'x-title': 'Update Space',
+        'x-title': 'Update a Space',
       },
     },
     '/thermostats/activate_climate_preset': {
@@ -35125,13 +35256,13 @@ export default {
                 properties: {
                   cooling_set_point_celsius: {
                     description:
-                      'Desired [cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C. You must set one of the `cooling_set_point` parameters.',
+                      '[Cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C that you want to set for the thermostat. You must set one of the `cooling_set_point` parameters.',
                     format: 'float',
                     type: 'number',
                   },
                   cooling_set_point_fahrenheit: {
                     description:
-                      'Desired [cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F. You must set one of the `cooling_set_point` parameters.',
+                      '[Cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F that you want to set for the thermostat. You must set one of the `cooling_set_point` parameters.',
                     format: 'float',
                     type: 'number',
                   },
@@ -35303,7 +35434,7 @@ export default {
     '/thermostats/daily_programs/create': {
       post: {
         description:
-          'Creates a thermostat daily program. A daily program consists of a set of periods, where each period includes a start time and the key of a configured climate preset. Once you have defined a daily program, you can assign it to one or more days within a weekly program.',
+          'Creates a new thermostat daily program. A daily program consists of a set of periods, where each period includes a start time and the key of a configured climate preset. Once you have defined a daily program, you can assign it to one or more days within a weekly program.',
         operationId: 'thermostatsDailyProgramsCreatePost',
         requestBody: {
           content: {
@@ -35317,8 +35448,7 @@ export default {
                     type: 'string',
                   },
                   name: {
-                    description:
-                      'User-friendly name to identify the thermostat daily program.',
+                    description: 'Name of the thermostat daily program.',
                     type: 'string',
                   },
                   periods: {
@@ -35518,7 +35648,7 @@ export default {
                 properties: {
                   name: {
                     description:
-                      'User-friendly name to identify the thermostat daily program that you want to update.',
+                      'Name of the thermostat daily program that you want to update.',
                     type: 'string',
                   },
                   periods: {
@@ -35603,7 +35733,7 @@ export default {
                 properties: {
                   name: {
                     description:
-                      'User-friendly name to identify the thermostat daily program that you want to update.',
+                      'Name of the thermostat daily program that you want to update.',
                     type: 'string',
                   },
                   periods: {
@@ -35741,7 +35871,7 @@ export default {
     '/thermostats/get': {
       post: {
         description:
-          'Returns a specified [thermostat](https://docs.seam.co/latest/capability-guides/thermostats).',
+          'Returns a specified [thermostat](https://docs.seam.co/latest/capability-guides/thermostats). **Deprecated:** Will be removed. Use `/devices/get` instead.',
         operationId: 'thermostatsGetPost',
         requestBody: {
           content: {
@@ -35750,13 +35880,13 @@ export default {
                 properties: {
                   device_id: {
                     description:
-                      'ID of the thermostat device that you want to retrieve.',
+                      'ID of the thermostat device that you want to get.',
                     format: 'uuid',
                     type: 'string',
                   },
                   name: {
                     description:
-                      'User-friendly name of the thermostat device that you want to retrieve.',
+                      'Name of the thermostat device that you want to retrieve.',
                     type: 'string',
                   },
                 },
@@ -35819,13 +35949,13 @@ export default {
                   },
                   heating_set_point_celsius: {
                     description:
-                      'Desired [heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C. You must set one of the `heating_set_point` parameters.',
+                      '[Heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C that you want to set for the thermostat. You must set one of the `heating_set_point` parameters.',
                     format: 'float',
                     type: 'number',
                   },
                   heating_set_point_fahrenheit: {
                     description:
-                      'Desired [heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F. You must set one of the `heating_set_point` parameters.',
+                      '[Heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F that you want to set for the thermostat. You must set one of the `heating_set_point` parameters.',
                     format: 'float',
                     type: 'number',
                   },
@@ -35890,13 +36020,13 @@ export default {
                 properties: {
                   cooling_set_point_celsius: {
                     description:
-                      'Desired [cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C. You must set one of the `cooling_set_point` parameters.',
+                      '[Cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C that you want to set for the thermostat. You must set one of the `cooling_set_point` parameters.',
                     format: 'float',
                     type: 'number',
                   },
                   cooling_set_point_fahrenheit: {
                     description:
-                      'Desired [cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F. You must set one of the `cooling_set_point` parameters.',
+                      '[Cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F that you want to set for the thermostat. You must set one of the `cooling_set_point` parameters.',
                     format: 'float',
                     type: 'number',
                   },
@@ -35908,13 +36038,13 @@ export default {
                   },
                   heating_set_point_celsius: {
                     description:
-                      'Desired [heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C. You must set one of the `heating_set_point` parameters.',
+                      '[Heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C that you want to set for the thermostat. You must set one of the `heating_set_point` parameters.',
                     format: 'float',
                     type: 'number',
                   },
                   heating_set_point_fahrenheit: {
                     description:
-                      'Desired [heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F. You must set one of the `heating_set_point` parameters.',
+                      '[Heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F that you want to set for the thermostat. You must set one of the `heating_set_point` parameters.',
                     format: 'float',
                     type: 'number',
                   },
@@ -36021,7 +36151,7 @@ export default {
                   },
                   device_type: {
                     description:
-                      'Device type by which to filter thermostat devices.',
+                      'Device type by which you want to filter thermostat devices.',
                     enum: [
                       'ecobee_thermostat',
                       'nest_thermostat',
@@ -36034,7 +36164,7 @@ export default {
                   },
                   device_types: {
                     description:
-                      'Array of device types by which to filter thermostat devices.',
+                      'Array of device types by which you want to filter thermostat devices.',
                     items: {
                       description: 'Device type for thermostats.\n          ',
                       enum: [
@@ -36098,7 +36228,7 @@ export default {
                   },
                   manufacturer: {
                     description:
-                      'Manufacturer by which to filter thermostat devices.',
+                      'Manufacturer by which you want to filter thermostat devices.',
                     enum: [
                       'ecobee',
                       'honeywell_resideo',
@@ -36248,7 +36378,7 @@ export default {
     '/thermostats/schedules/create': {
       post: {
         description:
-          'Creates a [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules) for a specified [thermostat](https://docs.seam.co/latest/capability-guides/thermostats).',
+          'Creates a new [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules) for a specified [thermostat](https://docs.seam.co/latest/capability-guides/thermostats).',
         operationId: 'thermostatsSchedulesCreatePost',
         requestBody: {
           content: {
@@ -36257,21 +36387,22 @@ export default {
                 properties: {
                   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 thermostat schedule.',
+                      'Key of the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) to use for the new thermostat schedule.',
                     type: 'string',
                   },
                   device_id: {
-                    description: 'ID of the desired thermostat device.',
+                    description:
+                      'ID of the thermostat device for which you want to create a schedule.',
                     type: 'string',
                   },
                   ends_at: {
                     description:
-                      'Date and time at which the thermostat schedule ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
+                      'Date and time at which the new thermostat schedule ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
                     type: 'string',
                   },
                   is_override_allowed: {
                     description:
-                      "Indicates whether a person at the thermostat or using the API can change the thermostat's settings while the schedule is active. See also [Specifying Manual Override Permissions](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).",
+                      "Indicates whether a person at the thermostat or using the API can change the thermostat's settings while the new schedule is active. See also [Specifying Manual Override Permissions](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).",
                     type: 'boolean',
                   },
                   max_override_period_minutes: {
@@ -36283,13 +36414,12 @@ export default {
                     type: 'integer',
                   },
                   name: {
-                    description:
-                      'User-friendly name to identify the thermostat schedule.',
+                    description: 'Name of the thermostat schedule.',
                     type: 'string',
                   },
                   starts_at: {
                     description:
-                      'Date and time at which the thermostat schedule starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
+                      'Date and time at which the new thermostat schedule starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
                     type: 'string',
                   },
                 },
@@ -36351,7 +36481,8 @@ export default {
               schema: {
                 properties: {
                   thermostat_schedule_id: {
-                    description: 'ID of the desired thermostat schedule.',
+                    description:
+                      'ID of the thermostat schedule that you want to delete.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -36403,7 +36534,8 @@ export default {
               schema: {
                 properties: {
                   thermostat_schedule_id: {
-                    description: 'ID of the desired thermostat schedule.',
+                    description:
+                      'ID of the thermostat schedule that you want to get.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -36461,7 +36593,8 @@ export default {
               schema: {
                 properties: {
                   device_id: {
-                    description: 'ID of the desired thermostat device.',
+                    description:
+                      'ID of the thermostat device for which you want to list schedules.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -36550,8 +36683,7 @@ export default {
                     type: 'integer',
                   },
                   name: {
-                    description:
-                      'User-friendly name to identify the thermostat schedule.',
+                    description: 'Name of the thermostat schedule.',
                     type: 'string',
                   },
                   starts_at: {
@@ -36560,7 +36692,8 @@ export default {
                     type: 'string',
                   },
                   thermostat_schedule_id: {
-                    description: 'ID of the desired thermostat schedule.',
+                    description:
+                      'ID of the thermostat schedule that you want to update.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -36632,8 +36765,7 @@ export default {
                     type: 'integer',
                   },
                   name: {
-                    description:
-                      'User-friendly name to identify the thermostat schedule.',
+                    description: 'Name of the thermostat schedule.',
                     type: 'string',
                   },
                   starts_at: {
@@ -36642,7 +36774,8 @@ export default {
                     type: 'string',
                   },
                   thermostat_schedule_id: {
-                    description: 'ID of the desired thermostat schedule.',
+                    description:
+                      'ID of the thermostat schedule that you want to update.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -36764,7 +36897,7 @@ export default {
                   },
                   fan_mode_setting: {
                     description:
-                      'Desired [fan mode setting](https://docs.seam.co/latest/capability-guides/thermostats/configure-current-climate-settings#fan-mode-settings) for the thermostat.',
+                      '[Fan mode setting](https://docs.seam.co/latest/capability-guides/thermostats/configure-current-climate-settings#fan-mode-settings) that you want to set for the thermostat.',
                     enum: ['auto', 'on', 'circulate'],
                     type: 'string',
                   },
@@ -36845,13 +36978,13 @@ export default {
                     properties: {
                       cooling_set_point_celsius: {
                         description:
-                          'Desired [cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C. You must set one of the `cooling_set_point` parameters.',
+                          '[Cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C that you want to set for the thermostat. You must set one of the `cooling_set_point` parameters.',
                         format: 'float',
                         type: 'number',
                       },
                       cooling_set_point_fahrenheit: {
                         description:
-                          'Desired [cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F. You must set one of the `cooling_set_point` parameters.',
+                          '[Cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F that you want to set for the thermostat. You must set one of the `cooling_set_point` parameters.',
                         format: 'float',
                         type: 'number',
                       },
@@ -36876,13 +37009,13 @@ export default {
                       },
                       heating_set_point_celsius: {
                         description:
-                          'Desired [heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C. You must set one of the `heating_set_point` parameters.',
+                          '[Heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C that you want to set for the thermostat. You must set one of the `heating_set_point` parameters.',
                         format: 'float',
                         type: 'number',
                       },
                       heating_set_point_fahrenheit: {
                         description:
-                          'Desired [heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F. You must set one of the `heating_set_point` parameters.',
+                          '[Heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F that you want to set for the thermostat. You must set one of the `heating_set_point` parameters.',
                         format: 'float',
                         type: 'number',
                       },
@@ -36895,13 +37028,13 @@ export default {
                     properties: {
                       cooling_set_point_celsius: {
                         description:
-                          'Desired [cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C. You must set one of the `cooling_set_point` parameters.',
+                          '[Cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C that you want to set for the thermostat. You must set one of the `cooling_set_point` parameters.',
                         format: 'float',
                         type: 'number',
                       },
                       cooling_set_point_fahrenheit: {
                         description:
-                          'Desired [cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F. You must set one of the `cooling_set_point` parameters.',
+                          '[Cooling set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F that you want to set for the thermostat. You must set one of the `cooling_set_point` parameters.',
                         format: 'float',
                         type: 'number',
                       },
@@ -36913,13 +37046,13 @@ export default {
                       },
                       heating_set_point_celsius: {
                         description:
-                          'Desired [heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C. You must set one of the `heating_set_point` parameters.',
+                          '[Heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C that you want to set for the thermostat. You must set one of the `heating_set_point` parameters.',
                         format: 'float',
                         type: 'number',
                       },
                       heating_set_point_fahrenheit: {
                         description:
-                          'Desired [heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F. You must set one of the `heating_set_point` parameters.',
+                          '[Heating set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F that you want to set for the thermostat. You must set one of the `heating_set_point` parameters.',
                         format: 'float',
                         type: 'number',
                       },
@@ -37152,13 +37285,13 @@ export default {
                   {
                     properties: {
                       device_id: {
-                        description: 'ID of the desired thermostat device.',
+                        description:
+                          'ID of the thermostat device for which you want to simulate having adjusted the HVAC mode.',
                         format: 'uuid',
                         type: 'string',
                       },
                       hvac_mode: {
-                        description:
-                          'Desired [HVAC mode](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/hvac-mode) to simulate.',
+                        description: 'HVAC mode that you want to simulate.',
                         enum: ['off'],
                         type: 'string',
                       },
@@ -37170,24 +37303,24 @@ export default {
                     properties: {
                       cooling_set_point_celsius: {
                         description:
-                          'Desired simulated cooling [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C. You must set `cooling_set_point_celsius` or `cooling_set_point_fahrenheit`.',
+                          'Cooling [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C that you want to simulate. You must set `cooling_set_point_celsius` or `cooling_set_point_fahrenheit`.',
                         format: 'float',
                         type: 'number',
                       },
                       cooling_set_point_fahrenheit: {
                         description:
-                          'Desired simulated cooling [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F. You must set `cooling_set_point_fahrenheit` or `cooling_set_point_celsius`.',
+                          'Cooling [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F that you want to simulate. You must set `cooling_set_point_fahrenheit` or `cooling_set_point_celsius`.',
                         format: 'float',
                         type: 'number',
                       },
                       device_id: {
-                        description: 'ID of the desired thermostat device.',
+                        description:
+                          'ID of the thermostat device for which you want to simulate having adjusted the HVAC mode.',
                         format: 'uuid',
                         type: 'string',
                       },
                       hvac_mode: {
-                        description:
-                          'Desired [HVAC mode](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/hvac-mode) to simulate.',
+                        description: 'HVAC mode that you want to simulate.',
                         enum: ['cool'],
                         type: 'string',
                       },
@@ -37198,25 +37331,25 @@ export default {
                   {
                     properties: {
                       device_id: {
-                        description: 'ID of the desired thermostat device.',
+                        description:
+                          'ID of the thermostat device for which you want to simulate having adjusted the HVAC mode.',
                         format: 'uuid',
                         type: 'string',
                       },
                       heating_set_point_celsius: {
                         description:
-                          'Desired simulated heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C. You must set `heating_set_point_celsius` or `heating_set_point_fahrenheit`.',
+                          'Heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C that you want to simulate. You must set `heating_set_point_celsius` or `heating_set_point_fahrenheit`.',
                         format: 'float',
                         type: 'number',
                       },
                       heating_set_point_fahrenheit: {
                         description:
-                          'Desired simulated heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F. You must set `heating_set_point_fahrenheit` or `heating_set_point_celsius`.',
+                          'Heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F that you want to simulate. You must set `heating_set_point_fahrenheit` or `heating_set_point_celsius`.',
                         format: 'float',
                         type: 'number',
                       },
                       hvac_mode: {
-                        description:
-                          'Desired [HVAC mode](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/hvac-mode) to simulate.',
+                        description: 'HVAC mode that you want to simulate.',
                         enum: ['heat'],
                         type: 'string',
                       },
@@ -37228,36 +37361,36 @@ export default {
                     properties: {
                       cooling_set_point_celsius: {
                         description:
-                          'Desired simulated cooling [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C. You must set `cooling_set_point_celsius` or `cooling_set_point_fahrenheit`.',
+                          'Cooling [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C that you want to simulate. You must set `cooling_set_point_celsius` or `cooling_set_point_fahrenheit`.',
                         format: 'float',
                         type: 'number',
                       },
                       cooling_set_point_fahrenheit: {
                         description:
-                          'Desired simulated cooling [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F. You must set `cooling_set_point_fahrenheit` or `cooling_set_point_celsius`.',
+                          'Cooling [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F that you want to simulate. You must set `cooling_set_point_fahrenheit` or `cooling_set_point_celsius`.',
                         format: 'float',
                         type: 'number',
                       },
                       device_id: {
-                        description: 'ID of the desired thermostat device.',
+                        description:
+                          'ID of the thermostat device for which you want to simulate having adjusted the HVAC mode.',
                         format: 'uuid',
                         type: 'string',
                       },
                       heating_set_point_celsius: {
                         description:
-                          'Desired simulated heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C. You must set `heating_set_point_celsius` or `heating_set_point_fahrenheit`.',
+                          'Heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °C that you want to simulate. You must set `heating_set_point_celsius` or `heating_set_point_fahrenheit`.',
                         format: 'float',
                         type: 'number',
                       },
                       heating_set_point_fahrenheit: {
                         description:
-                          'Desired simulated heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F. You must set `heating_set_point_fahrenheit` or `heating_set_point_celsius`.',
+                          'Heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points) in °F that you want to simulate. You must set `heating_set_point_fahrenheit` or `heating_set_point_celsius`.',
                         format: 'float',
                         type: 'number',
                       },
                       hvac_mode: {
-                        description:
-                          'Desired [HVAC mode](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/hvac-mode) to simulate.',
+                        description: 'HVAC mode that you want to simulate.',
                         enum: ['heat_cool'],
                         type: 'string',
                       },
@@ -37310,19 +37443,20 @@ export default {
               schema: {
                 properties: {
                   device_id: {
-                    description: 'ID of the desired thermostat device.',
+                    description:
+                      'ID of the thermostat device that you want to simulate reaching a specified temperature.',
                     format: 'uuid',
                     type: 'string',
                   },
                   temperature_celsius: {
                     description:
-                      'Desired simulated temperature in °C. You must set `temperature_celsius` or `temperature_fahrenheit`.',
+                      'Temperature in °C that you want simulate the thermostat reaching. You must set `temperature_celsius` or `temperature_fahrenheit`.',
                     format: 'float',
                     type: 'number',
                   },
                   temperature_fahrenheit: {
                     description:
-                      'Desired simulated temperature in °F. You must set `temperature_fahrenheit` or `temperature_celsius`.',
+                      'Temperature in °F that you want simulate the thermostat reaching. You must set `temperature_fahrenheit` or `temperature_celsius`.',
                     format: 'float',
                     type: 'number',
                   },
@@ -37701,7 +37835,7 @@ export default {
                         properties: {
                           user_identity_id: {
                             description:
-                              'ID of user identity for whom access is being granted.',
+                              'ID of user identity for whom you want to grant access.',
                             format: 'uuid',
                             type: 'string',
                           },
@@ -37713,7 +37847,7 @@ export default {
                         properties: {
                           user_identity: {
                             description:
-                              'When used, creates a new user identity with the given details, and grants them access.',
+                              'User identity. When used, creates a new user identity with the specified details and grants them access.',
                             properties: {
                               email_address: {
                                 description:
@@ -37747,14 +37881,14 @@ export default {
                       acs_entrance_ids: {
                         default: [],
                         description:
-                          'Set of IDs of the [entrances](https://docs.seam.co/latest/api/acs/systems/list) to which access is being granted.',
+                          'IDs of the [entrances](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details) to which you want to grant access.',
                         items: { format: 'uuid', type: 'string' },
                         type: 'array',
                       },
                       device_ids: {
                         default: [],
                         description:
-                          'Set of IDs of the [devices](https://docs.seam.co/latest/api/devices/list) to which access is being granted.',
+                          'IDs of the devices to which you want to grant access.',
                         items: { format: 'uuid', type: 'string' },
                         type: 'array',
                       },
@@ -37766,7 +37900,7 @@ export default {
                       },
                       location: {
                         description:
-                          'When used, creates a new location with the given entrances and devices, and gives the user access to this location.',
+                          'Location. When used, creates a new location with the specified entrances and devices, and gives the user access to this location.',
                         properties: {
                           acs_entrance_ids: {
                             default: [],
@@ -37801,8 +37935,7 @@ export default {
                         items: {
                           properties: {
                             mode: {
-                              description:
-                                'Access method mode. Supported values: `code`, `card`, `mobile_key`.',
+                              description: 'Access method mode.',
                               enum: ['code', 'card', 'mobile_key'],
                               type: 'string',
                             },
@@ -37814,7 +37947,7 @@ export default {
                       },
                       space_ids: {
                         description:
-                          'Set of IDs of existing spaces to which access is being granted.',
+                          'IDs of the existing spaces to which you want to grant access.',
                         items: { format: 'uuid', type: 'string' },
                         type: 'array',
                       },
@@ -37971,7 +38104,7 @@ export default {
     },
     '/unstable_access_grants/delete': {
       post: {
-        description: 'Delete an access grant.',
+        description: 'Deletes an access grant.',
         operationId: 'unstableAccessGrantsDeletePost',
         requestBody: {
           content: {
@@ -37979,7 +38112,7 @@ export default {
               schema: {
                 properties: {
                   access_grant_id: {
-                    description: 'ID of access grant to delete.',
+                    description: 'ID of access grant that you want to delete.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -38023,7 +38156,7 @@ export default {
     },
     '/unstable_access_grants/get': {
       post: {
-        description: 'Get an access grant.',
+        description: 'Gets an access grant.',
         operationId: 'unstableAccessGrantsGetPost',
         requestBody: {
           content: {
@@ -38031,7 +38164,7 @@ export default {
               schema: {
                 properties: {
                   access_grant_id: {
-                    description: 'ID of access grant to get.',
+                    description: 'ID of access grant that you want to get.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -38180,7 +38313,7 @@ export default {
     },
     '/unstable_access_grants/list': {
       post: {
-        description: 'Get an access grant.',
+        description: 'Returns a list of all access grants.',
         operationId: 'unstableAccessGrantsListPost',
         requestBody: {
           content: {
@@ -38189,13 +38322,13 @@ export default {
                 properties: {
                   acs_entrance_id: {
                     description:
-                      'ID of entrance to filter list of access grants by.',
+                      'ID of the entrance by which you want to filter the list of access grants.',
                     format: 'uuid',
                     type: 'string',
                   },
                   acs_system_id: {
                     description:
-                      'ID of system to filter list of access grants by.',
+                      'ID of the access system by which you want to filter the list of access grants.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -38207,13 +38340,13 @@ export default {
                   },
                   space_id: {
                     description:
-                      'ID of space to filter list of access grants by.',
+                      'ID of the space by which you want to filter the list of access grants.',
                     format: 'uuid',
                     type: 'string',
                   },
                   user_identity_id: {
                     description:
-                      'ID of user identity to filter list of access grants by.',
+                      'ID of the user identity by which you want to filter the list of access grants.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -38364,7 +38497,7 @@ export default {
     },
     '/unstable_access_methods/delete': {
       post: {
-        description: 'Delete an access method.',
+        description: 'Deletes an access method.',
         operationId: 'unstableAccessMethodsDeletePost',
         requestBody: {
           content: {
@@ -38372,7 +38505,8 @@ export default {
               schema: {
                 properties: {
                   access_method_id: {
-                    description: 'ID of access method to get.',
+                    description:
+                      'ID of the access method that you want to delete.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -38415,7 +38549,7 @@ export default {
     },
     '/unstable_access_methods/get': {
       post: {
-        description: 'Get an access method.',
+        description: 'Gets an access method.',
         operationId: 'unstableAccessMethodsGetPost',
         requestBody: {
           content: {
@@ -38423,7 +38557,8 @@ export default {
               schema: {
                 properties: {
                   access_method_id: {
-                    description: 'ID of access method to get.',
+                    description:
+                      'ID of the access method that you want to get.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -38527,7 +38662,7 @@ export default {
     '/unstable_access_methods/list': {
       post: {
         description:
-          'List all access methods, usually filtered by access grant.',
+          'Lists all access methods, usually filtered by access grant.',
         operationId: 'unstableAccessMethodsListPost',
         requestBody: {
           content: {
@@ -38536,7 +38671,7 @@ export default {
                 properties: {
                   access_grant_id: {
                     description:
-                      'ID of access grant to list access methods for.',
+                      'ID of the access grant by which to filter the list of access methods.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -38642,7 +38777,8 @@ export default {
     },
     '/unstable_locations/add_acs_entrances': {
       post: {
-        description: 'Add entrances to a specific location.',
+        description:
+          'Adds [entrances](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details) to a specific location.',
         operationId: 'unstableLocationsAddAcsEntrancesPost',
         requestBody: {
           content: {
@@ -38650,11 +38786,18 @@ export default {
               schema: {
                 properties: {
                   acs_entrance_ids: {
+                    description:
+                      'IDs of the entrances that you want to add to the location.',
                     items: { format: 'uuid', type: 'string' },
                     minItems: 1,
                     type: 'array',
                   },
-                  location_id: { format: 'uuid', type: 'string' },
+                  location_id: {
+                    description:
+                      'ID of the location to which you want to add entrances.',
+                    format: 'uuid',
+                    type: 'string',
+                  },
                 },
                 required: ['location_id', 'acs_entrance_ids'],
                 type: 'object',
@@ -38688,11 +38831,12 @@ export default {
         'x-fern-sdk-group-name': ['unstable_locations'],
         'x-fern-sdk-method-name': 'add_acs_entrances',
         'x-response-key': null,
-        'x-title': 'Add ACS Entrances',
+        'x-title': 'Add Entrances to a Location',
         'x-undocumented': 'Experimental locations.',
       },
       put: {
-        description: 'Add entrances to a specific location.',
+        description:
+          'Adds [entrances](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details) to a specific location.',
         operationId: 'unstableLocationsAddAcsEntrancesPut',
         requestBody: {
           content: {
@@ -38700,11 +38844,18 @@ export default {
               schema: {
                 properties: {
                   acs_entrance_ids: {
+                    description:
+                      'IDs of the entrances that you want to add to the location.',
                     items: { format: 'uuid', type: 'string' },
                     minItems: 1,
                     type: 'array',
                   },
-                  location_id: { format: 'uuid', type: 'string' },
+                  location_id: {
+                    description:
+                      'ID of the location to which you want to add entrances.',
+                    format: 'uuid',
+                    type: 'string',
+                  },
                 },
                 required: ['location_id', 'acs_entrance_ids'],
                 type: 'object',
@@ -38737,13 +38888,13 @@ export default {
         tags: [],
         'x-fern-ignore': true,
         'x-response-key': null,
-        'x-title': 'Add ACS Entrances',
+        'x-title': 'Add Entrances to a Location',
         'x-undocumented': 'Experimental locations.',
       },
     },
     '/unstable_locations/add_devices': {
       post: {
-        description: 'Add devices to a specific location.',
+        description: 'Adds devices to a specific location.',
         operationId: 'unstableLocationsAddDevicesPost',
         requestBody: {
           content: {
@@ -38751,11 +38902,18 @@ export default {
               schema: {
                 properties: {
                   device_ids: {
+                    description:
+                      'IDs of the devices that you want to add to the location.',
                     items: { format: 'uuid', type: 'string' },
                     minItems: 1,
                     type: 'array',
                   },
-                  location_id: { format: 'uuid', type: 'string' },
+                  location_id: {
+                    description:
+                      'ID of the location to which you want to add devices.',
+                    format: 'uuid',
+                    type: 'string',
+                  },
                 },
                 required: ['location_id', 'device_ids'],
                 type: 'object',
@@ -38789,11 +38947,11 @@ export default {
         'x-fern-sdk-group-name': ['unstable_locations'],
         'x-fern-sdk-method-name': 'add_devices',
         'x-response-key': null,
-        'x-title': 'Add Location Devices',
+        'x-title': 'Add Devices to a Location',
         'x-undocumented': 'Experimental locations.',
       },
       put: {
-        description: 'Add devices to a specific location.',
+        description: 'Adds devices to a specific location.',
         operationId: 'unstableLocationsAddDevicesPut',
         requestBody: {
           content: {
@@ -38801,11 +38959,18 @@ export default {
               schema: {
                 properties: {
                   device_ids: {
+                    description:
+                      'IDs of the devices that you want to add to the location.',
                     items: { format: 'uuid', type: 'string' },
                     minItems: 1,
                     type: 'array',
                   },
-                  location_id: { format: 'uuid', type: 'string' },
+                  location_id: {
+                    description:
+                      'ID of the location to which you want to add devices.',
+                    format: 'uuid',
+                    type: 'string',
+                  },
                 },
                 required: ['location_id', 'device_ids'],
                 type: 'object',
@@ -38838,13 +39003,13 @@ export default {
         tags: [],
         'x-fern-ignore': true,
         'x-response-key': null,
-        'x-title': 'Add Location Devices',
+        'x-title': 'Add Devices to a Location',
         'x-undocumented': 'Experimental locations.',
       },
     },
     '/unstable_locations/create': {
       post: {
-        description: 'Create a new location.',
+        description: 'Creates a new location.',
         operationId: 'unstableLocationsCreatePost',
         requestBody: {
           content: {
@@ -38852,14 +39017,19 @@ export default {
               schema: {
                 properties: {
                   acs_entrance_ids: {
+                    description:
+                      'IDs of the entrances that you want to add to the new location.',
                     items: { format: 'uuid', type: 'string' },
                     type: 'array',
                   },
                   device_ids: {
+                    description:
+                      'IDs of the devices that you want to add to the new location.',
                     items: { format: 'uuid', type: 'string' },
                     type: 'array',
                   },
                   geolocation: {
+                    description: 'Geolocation of the new location.',
                     properties: {
                       latitude: { format: 'float', type: 'number' },
                       longitude: { format: 'float', type: 'number' },
@@ -38867,8 +39037,14 @@ export default {
                     required: ['latitude', 'longitude'],
                     type: 'object',
                   },
-                  name: { type: 'string' },
-                  time_zone: { type: 'string' },
+                  name: {
+                    description: 'Name of the new location.',
+                    type: 'string',
+                  },
+                  time_zone: {
+                    description: 'Time zone of the new location.',
+                    type: 'string',
+                  },
                 },
                 required: ['name'],
                 type: 'object',
@@ -38955,19 +39131,25 @@ export default {
         'x-fern-sdk-method-name': 'create',
         'x-fern-sdk-return-value': 'location',
         'x-response-key': 'location',
-        'x-title': 'Create Location',
+        'x-title': 'Create a Location',
         'x-undocumented': 'Experimental locations.',
       },
     },
     '/unstable_locations/delete': {
       post: {
-        description: 'Delete a location.',
+        description: 'Deletes a location.',
         operationId: 'unstableLocationsDeletePost',
         requestBody: {
           content: {
             'application/json': {
               schema: {
-                properties: { location_id: { format: 'uuid', type: 'string' } },
+                properties: {
+                  location_id: {
+                    description: 'ID of the location that you want to delete.',
+                    format: 'uuid',
+                    type: 'string',
+                  },
+                },
                 required: ['location_id'],
                 type: 'object',
               },
@@ -39000,19 +39182,25 @@ export default {
         'x-fern-sdk-group-name': ['unstable_locations'],
         'x-fern-sdk-method-name': 'delete',
         'x-response-key': null,
-        'x-title': 'Delete Location',
+        'x-title': 'Delete a Location',
         'x-undocumented': 'Experimental locations.',
       },
     },
     '/unstable_locations/get': {
       post: {
-        description: 'Get a location.',
+        description: 'Gets a location.',
         operationId: 'unstableLocationsGetPost',
         requestBody: {
           content: {
             'application/json': {
               schema: {
-                properties: { location_id: { format: 'uuid', type: 'string' } },
+                properties: {
+                  location_id: {
+                    description: 'ID of the location that you want to get.',
+                    format: 'uuid',
+                    type: 'string',
+                  },
+                },
                 required: ['location_id'],
                 type: 'object',
               },
@@ -39098,7 +39286,7 @@ export default {
         'x-fern-sdk-method-name': 'get',
         'x-fern-sdk-return-value': 'location',
         'x-response-key': 'location',
-        'x-title': 'Get Location',
+        'x-title': 'Get a Location',
         'x-undocumented': 'Experimental locations.',
       },
     },
@@ -39282,7 +39470,7 @@ export default {
     },
     '/unstable_locations/remove_acs_entrances': {
       post: {
-        description: 'Remove entrances from a specific location.',
+        description: 'Removes entrances from a specific location.',
         operationId: 'unstableLocationsRemoveAcsEntrancesPost',
         requestBody: {
           content: {
@@ -39290,10 +39478,17 @@ export default {
               schema: {
                 properties: {
                   acs_entrance_ids: {
+                    description:
+                      'IDs of the entrances that you want to remove from the location.',
                     items: { format: 'uuid', type: 'string' },
                     type: 'array',
                   },
-                  location_id: { format: 'uuid', type: 'string' },
+                  location_id: {
+                    description:
+                      'ID of the location from which you want to remove entrances.',
+                    format: 'uuid',
+                    type: 'string',
+                  },
                 },
                 required: ['location_id', 'acs_entrance_ids'],
                 type: 'object',
@@ -39327,13 +39522,13 @@ export default {
         'x-fern-sdk-group-name': ['unstable_locations'],
         'x-fern-sdk-method-name': 'remove_acs_entrances',
         'x-response-key': null,
-        'x-title': 'Remove ACS Entrances',
+        'x-title': 'Remove Entrances from a Location',
         'x-undocumented': 'Experimental locations.',
       },
     },
     '/unstable_locations/remove_devices': {
       post: {
-        description: 'Remove devices from a specific location.',
+        description: 'Removes devices from a specific location.',
         operationId: 'unstableLocationsRemoveDevicesPost',
         requestBody: {
           content: {
@@ -39341,10 +39536,17 @@ export default {
               schema: {
                 properties: {
                   device_ids: {
+                    description:
+                      'IDs of the devices that you want to remove from the location.',
                     items: { format: 'uuid', type: 'string' },
                     type: 'array',
                   },
-                  location_id: { format: 'uuid', type: 'string' },
+                  location_id: {
+                    description:
+                      'ID of the location from which you want to remove devices.',
+                    format: 'uuid',
+                    type: 'string',
+                  },
                 },
                 required: ['location_id', 'device_ids'],
                 type: 'object',
@@ -39378,13 +39580,13 @@ export default {
         'x-fern-sdk-group-name': ['unstable_locations'],
         'x-fern-sdk-method-name': 'remove_devices',
         'x-response-key': null,
-        'x-title': 'Remove Location Devices',
+        'x-title': 'Remove Devices from a Location',
         'x-undocumented': 'Experimental locations.',
       },
     },
     '/unstable_locations/update': {
       patch: {
-        description: 'Update an existing location.',
+        description: 'Updates a location.',
         operationId: 'unstableLocationsUpdatePatch',
         requestBody: {
           content: {
@@ -39392,6 +39594,7 @@ export default {
               schema: {
                 properties: {
                   geolocation: {
+                    description: 'Geolocation of the location.',
                     properties: {
                       latitude: { format: 'float', type: 'number' },
                       longitude: { format: 'float', type: 'number' },
@@ -39399,9 +39602,19 @@ export default {
                     required: ['latitude', 'longitude'],
                     type: 'object',
                   },
-                  location_id: { format: 'uuid', type: 'string' },
-                  name: { type: 'string' },
-                  time_zone: { type: 'string' },
+                  location_id: {
+                    description: 'ID of the location that you want to update.',
+                    format: 'uuid',
+                    type: 'string',
+                  },
+                  name: {
+                    description: 'Name of the location.',
+                    type: 'string',
+                  },
+                  time_zone: {
+                    description: 'Time zone of the the location.',
+                    type: 'string',
+                  },
                 },
                 required: ['location_id'],
                 type: 'object',
@@ -39486,11 +39699,11 @@ export default {
         tags: [],
         'x-fern-ignore': true,
         'x-response-key': 'location',
-        'x-title': 'Update Location',
+        'x-title': 'Update a Location',
         'x-undocumented': 'Experimental locations.',
       },
       post: {
-        description: 'Update an existing location.',
+        description: 'Updates a location.',
         operationId: 'unstableLocationsUpdatePost',
         requestBody: {
           content: {
@@ -39498,6 +39711,7 @@ export default {
               schema: {
                 properties: {
                   geolocation: {
+                    description: 'Geolocation of the location.',
                     properties: {
                       latitude: { format: 'float', type: 'number' },
                       longitude: { format: 'float', type: 'number' },
@@ -39505,9 +39719,19 @@ export default {
                     required: ['latitude', 'longitude'],
                     type: 'object',
                   },
-                  location_id: { format: 'uuid', type: 'string' },
-                  name: { type: 'string' },
-                  time_zone: { type: 'string' },
+                  location_id: {
+                    description: 'ID of the location that you want to update.',
+                    format: 'uuid',
+                    type: 'string',
+                  },
+                  name: {
+                    description: 'Name of the location.',
+                    type: 'string',
+                  },
+                  time_zone: {
+                    description: 'Time zone of the the location.',
+                    type: 'string',
+                  },
                 },
                 required: ['location_id'],
                 type: 'object',
@@ -39594,7 +39818,7 @@ export default {
         'x-fern-sdk-method-name': 'update',
         'x-fern-sdk-return-value': 'location',
         'x-response-key': 'location',
-        'x-title': 'Update Location',
+        'x-title': 'Update a Location',
         'x-undocumented': 'Experimental locations.',
       },
     },
@@ -39607,7 +39831,13 @@ export default {
           content: {
             'application/json': {
               schema: {
-                properties: { customer_key: { type: 'string' } },
+                properties: {
+                  customer_key: {
+                    description:
+                      'Customer key for which you want to connect accounts.',
+                    type: 'string',
+                  },
+                },
                 required: ['customer_key'],
                 type: 'object',
               },
@@ -39644,7 +39874,7 @@ export default {
         'x-fern-sdk-method-name': 'connect_accounts',
         'x-fern-sdk-return-value': 'magic_link',
         'x-response-key': 'magic_link',
-        'x-title': 'Connect Accounts',
+        'x-title': 'Generate a Connect Accounts Building Block Magic Link',
         'x-undocumented': 'Experimental partner building blocks.',
       },
     },
@@ -39656,61 +39886,46 @@ export default {
           content: {
             'application/json': {
               schema: {
-                oneOf: [
-                  {
-                    properties: {
-                      building_block_type: {
-                        enum: ['connect_accounts'],
-                        type: 'string',
-                      },
-                      customer_key: { type: 'string' },
-                    },
-                    required: ['building_block_type', 'customer_key'],
-                    type: 'object',
+                properties: {
+                  building_block_type: {
+                    description:
+                      'Type of building block to create a magic link for.',
+                    enum: [
+                      'connect_accounts',
+                      'organize_spaces',
+                      'console',
+                      'manage_devices',
+                    ],
+                    type: 'string',
                   },
-                  {
-                    properties: {
-                      building_block_type: {
-                        enum: ['manage_devices'],
-                        type: 'string',
-                      },
-                      customer_key: { type: 'string' },
-                    },
-                    required: ['building_block_type', 'customer_key'],
-                    type: 'object',
+                  customer_key: {
+                    description:
+                      'Customer key for which you want to create a new building block magic link.',
+                    type: 'string',
                   },
-                  {
-                    properties: {
-                      building_block_type: {
-                        enum: ['organize_spaces'],
-                        type: 'string',
-                      },
-                      customer_key: { type: 'string' },
-                      partner_resources: {
-                        description:
-                          'Optional list of partner resources to include in the magic link.',
-                        items: {
-                          properties: {
-                            custom_metadata: {
-                              additionalProperties: { type: 'string' },
-                              type: 'object',
-                            },
-                            description: { type: 'string' },
-                            name: { type: 'string' },
-                            partner_resource_key: { type: 'string' },
-                          },
-                          required: ['partner_resource_key', 'name'],
+                  spaces: {
+                    description:
+                      'Optional list of spaces that you want to include in the new building block magic link.',
+                    items: {
+                      properties: {
+                        custom_metadata: {
+                          additionalProperties: { type: 'string' },
                           type: 'object',
-                          'x-route-path': '/unstable_partner/resources',
-                          'x-undocumented': 'Unreleased.',
                         },
-                        type: 'array',
+                        description: { type: 'string' },
+                        name: { type: 'string' },
+                        space_key: { type: 'string' },
                       },
+                      required: ['space_key', 'name'],
+                      type: 'object',
+                      'x-route-path': '/unstable_partner/resources',
+                      'x-undocumented': 'Unreleased.',
                     },
-                    required: ['building_block_type', 'customer_key'],
-                    type: 'object',
+                    type: 'array',
                   },
-                ],
+                },
+                required: ['building_block_type', 'customer_key'],
+                type: 'object',
               },
             },
           },
@@ -39745,7 +39960,7 @@ export default {
         'x-fern-sdk-method-name': 'generate_magic_link',
         'x-fern-sdk-return-value': 'magic_link',
         'x-response-key': 'magic_link',
-        'x-title': 'Generate a building block magic link',
+        'x-title': 'Generate a Building Block Magic Link',
         'x-undocumented': 'Experimental partner building blocks.',
       },
     },
@@ -39758,7 +39973,13 @@ export default {
           content: {
             'application/json': {
               schema: {
-                properties: { customer_key: { type: 'string' } },
+                properties: {
+                  customer_key: {
+                    description:
+                      'Customer key for which you want to manage devices.',
+                    type: 'string',
+                  },
+                },
                 required: ['customer_key'],
                 type: 'object',
               },
@@ -39795,7 +40016,7 @@ export default {
         'x-fern-sdk-method-name': 'manage_devices',
         'x-fern-sdk-return-value': 'magic_link',
         'x-response-key': 'magic_link',
-        'x-title': 'Manage Devices',
+        'x-title': 'Generate a Manage Devices Building Block Magic Link',
         'x-undocumented': 'Experimental partner building blocks.',
       },
     },
@@ -39809,8 +40030,14 @@ export default {
             'application/json': {
               schema: {
                 properties: {
-                  customer_key: { type: 'string' },
-                  partner_resources: {
+                  customer_key: {
+                    description:
+                      'Customer key for which you want to organize spaces.',
+                    type: 'string',
+                  },
+                  spaces: {
+                    description:
+                      'Optional list of spaces that you want to include in the new building block magic link.',
                     items: {
                       properties: {
                         custom_metadata: {
@@ -39819,9 +40046,9 @@ export default {
                         },
                         description: { type: 'string' },
                         name: { type: 'string' },
-                        partner_resource_key: { type: 'string' },
+                        space_key: { type: 'string' },
                       },
-                      required: ['partner_resource_key', 'name'],
+                      required: ['space_key', 'name'],
                       type: 'object',
                       'x-route-path': '/unstable_partner/resources',
                       'x-undocumented': 'Unreleased.',
@@ -39865,13 +40092,13 @@ export default {
         'x-fern-sdk-method-name': 'organize_spaces',
         'x-fern-sdk-return-value': 'magic_link',
         'x-response-key': 'magic_link',
-        'x-title': 'Organize Spaces',
+        'x-title': 'Generate an Organize Spaces Building Block Magic Link',
         'x-undocumented': 'Experimental partner building blocks.',
       },
     },
     '/unstable_partner/resources/push': {
       post: {
-        description: 'Send Seam some of your resources.',
+        description: 'Sends Seam some of your resources.',
         operationId: 'unstablePartnerResourcesPushPost',
         requestBody: {
           content: {
@@ -39885,7 +40112,11 @@ export default {
                           additionalProperties: { type: 'string' },
                           type: 'object',
                         },
-                        customer_key: { type: 'string' },
+                        customer_key: {
+                          description:
+                            'Customer key associated with the resource that you want to push to Seam.',
+                          type: 'string',
+                        },
                         description: { type: 'string' },
                         email_address: { type: 'string' },
                         ends_at: { type: 'string' },
@@ -39894,8 +40125,16 @@ export default {
                           type: 'array',
                         },
                         name: { type: 'string' },
-                        partner_resource_key: { type: 'string' },
-                        partner_resource_type: { type: 'string' },
+                        partner_resource_key: {
+                          description:
+                            'Key of the resource that you want to push to Seam.',
+                          type: 'string',
+                        },
+                        partner_resource_type: {
+                          description:
+                            'Type of the resource that you want to push to Seam.',
+                          type: 'string',
+                        },
                         phone_number: { type: 'string' },
                         starts_at: { type: 'string' },
                         user_identity_key: { type: 'string' },
@@ -39912,7 +40151,11 @@ export default {
                         additionalProperties: { type: 'string' },
                         type: 'object',
                       },
-                      customer_key: { type: 'string' },
+                      customer_key: {
+                        description:
+                          'Customer key associated with the resource that you want to push to Seam.',
+                        type: 'string',
+                      },
                       description: { type: 'string' },
                       email_address: { type: 'string' },
                       ends_at: { type: 'string' },
@@ -39921,8 +40164,16 @@ export default {
                         type: 'array',
                       },
                       name: { type: 'string' },
-                      partner_resource_key: { type: 'string' },
-                      partner_resource_type: { type: 'string' },
+                      partner_resource_key: {
+                        description:
+                          'Key of the resource that you want to push to Seam.',
+                        type: 'string',
+                      },
+                      partner_resource_type: {
+                        description:
+                          'Type of the resource that you want to push to Seam.',
+                        type: 'string',
+                      },
                       phone_number: { type: 'string' },
                       starts_at: { type: 'string' },
                       user_identity_key: { type: 'string' },
@@ -39962,14 +40213,14 @@ export default {
         'x-fern-sdk-group-name': ['unstable_partner', 'resources'],
         'x-fern-sdk-method-name': 'push',
         'x-response-key': null,
-        'x-title': 'Push partner resources at Seam',
+        'x-title': 'Push Partner Resources at Seam',
         'x-undocumented': 'Experimental partner resources.',
       },
     },
     '/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).',
+          'Adds a specified [access system 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: {
@@ -39977,12 +40228,14 @@ export default {
               schema: {
                 properties: {
                   acs_user_id: {
-                    description: 'ID of the desired ACS user.',
+                    description:
+                      'ID of the access system user that you want to add to the user identity.',
                     format: 'uuid',
                     type: 'string',
                   },
                   user_identity_id: {
-                    description: 'ID of the desired user identity.',
+                    description:
+                      'ID of the user identity to which you want to add an access system user.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -40023,7 +40276,7 @@ export default {
       },
       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).',
+          'Adds a specified [access system 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: {
@@ -40031,12 +40284,14 @@ export default {
               schema: {
                 properties: {
                   acs_user_id: {
-                    description: 'ID of the desired ACS user.',
+                    description:
+                      'ID of the access system user that you want to add to the user identity.',
                     format: 'uuid',
                     type: 'string',
                   },
                   user_identity_id: {
-                    description: 'ID of the desired user identity.',
+                    description:
+                      'ID of the user identity to which you want to add an access system user.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -40087,31 +40342,32 @@ export default {
                 properties: {
                   acs_system_ids: {
                     description:
-                      "List of ACS system IDs to associate with the user identity through ACS users. If there's no user with the same email address or phone number in the specified ACS systems, a new ACS user is created. If there is an existing user with the same email or phone number in the specified ACS systems, the user is linked to the user identity.",
+                      "List of access system IDs to associate with the new user identity through access system users. If there's no user with the same email address or phone number in the specified access systems, a new access system user is created. If there is an existing user with the same email or phone number in the specified access systems, the user is linked to the user identity.",
                     items: { format: 'uuid', type: 'string' },
                     type: 'array',
                   },
                   email_address: {
-                    description: 'Unique email address for the user identity.',
+                    description:
+                      'Unique email address for the new user identity.',
                     format: 'email',
                     nullable: true,
                     type: 'string',
                   },
                   full_name: {
                     description:
-                      'Full name of the user associated with the user identity.',
+                      'Full name of the user associated with the new 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).',
+                      'Unique phone number for the new user identity in E.164 format (for example, +15555550100).',
                     nullable: true,
                     type: 'string',
                   },
                   user_identity_key: {
-                    description: 'Unique key for the user identity.',
+                    description: 'Unique key for the new user identity.',
                     minLength: 1,
                     nullable: true,
                     type: 'string',
@@ -40168,7 +40424,8 @@ export default {
               schema: {
                 properties: {
                   user_identity_id: {
-                    description: 'ID of the desired user identity.',
+                    description:
+                      'ID of the user identity that you want to delete.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -40219,7 +40476,8 @@ export default {
               schema: {
                 properties: {
                   enrollment_automation_id: {
-                    description: 'ID of the desired enrollment automation.',
+                    description:
+                      'ID of the enrollment automation that you want to delete.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -40270,7 +40528,8 @@ export default {
               schema: {
                 properties: {
                   enrollment_automation_id: {
-                    description: 'ID of the desired enrollment automation.',
+                    description:
+                      'ID of the enrollment automation that you want to get.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -40329,7 +40588,7 @@ export default {
                 properties: {
                   acs_credential_pool_id: {
                     description:
-                      'ID of the ACS credential pool from which to obtain credentials for the user identity.',
+                      'ID of the credential pool from which to obtain credentials for the user identity.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -40340,18 +40599,19 @@ export default {
                   },
                   credential_manager_acs_system_id: {
                     description:
-                      'ID of the desired ACS system that serves as the credential manager.',
+                      'ID of the desired access system that serves as the credential manager for the enrollment automation.',
                     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`.',
+                      'ID of the associated access system 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: {
-                    description: 'ID of the desired user identity.',
+                    description:
+                      'ID of the user identity for which you want to launch an enrollment automation.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -40437,7 +40697,7 @@ export default {
                 properties: {
                   user_identity_id: {
                     description:
-                      'ID of the user identity for which you want to retrieve all enrollment automations.',
+                      'ID of the user identity for which you want to retrieve enrollment automations.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -40500,7 +40760,7 @@ export default {
                   max_use_count: {
                     default: 1,
                     description:
-                      'The maximum number of times the instant key can be used. Defaults to 1.',
+                      'Maximum number of times the instant key can be used. Default: 1.',
                     format: 'float',
                     type: 'number',
                   },
@@ -40563,7 +40823,8 @@ export default {
                   {
                     properties: {
                       user_identity_id: {
-                        description: 'ID of the desired user identity.',
+                        description:
+                          'ID of the user identity that you want to get.',
                         format: 'uuid',
                         type: 'string',
                       },
@@ -40627,12 +40888,14 @@ export default {
               schema: {
                 properties: {
                   device_id: {
-                    description: 'ID of the desired managed device.',
+                    description:
+                      'ID of the managed device to which you want to grant access to the user identity.',
                     format: 'uuid',
                     type: 'string',
                   },
                   user_identity_id: {
-                    description: 'ID of the desired user identity.',
+                    description:
+                      'ID of the user identity that you want to grant access to a device.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -40681,12 +40944,14 @@ export default {
               schema: {
                 properties: {
                   device_id: {
-                    description: 'ID of the desired managed device.',
+                    description:
+                      'ID of the managed device to which you want to grant access to the user identity.',
                     format: 'uuid',
                     type: 'string',
                   },
                   user_identity_id: {
-                    description: 'ID of the desired user identity.',
+                    description:
+                      'ID of the user identity that you want to grant access to a device.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -40736,6 +41001,8 @@ export default {
               schema: {
                 properties: {
                   credential_manager_acs_system_id: {
+                    description:
+                      '`acs_system_id` of the credential manager by which you want to filter the list of user identities.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -40815,7 +41082,7 @@ export default {
                       deprecated: true,
                       items: { $ref: '#/components/schemas/device' },
                       type: 'array',
-                      'x-deprecated': 'use devices.',
+                      'x-deprecated': 'Use devices.',
                     },
                     devices: {
                       items: { $ref: '#/components/schemas/device' },
@@ -40850,7 +41117,7 @@ export default {
     '/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).',
+          'Returns a list of all [access 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: {
@@ -40859,7 +41126,7 @@ export default {
                 properties: {
                   user_identity_id: {
                     description:
-                      'ID of the user identity for which you want to retrieve all access control systems.',
+                      'ID of the user identity for which you want to retrieve all access systems.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -40910,7 +41177,7 @@ export default {
     '/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).',
+          'Returns a list of all [access system 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: {
@@ -40919,7 +41186,7 @@ export default {
                 properties: {
                   user_identity_id: {
                     description:
-                      'ID of the user identity for which you want to retrieve all ACS users.',
+                      'ID of the user identity for which you want to retrieve all access system users.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -40969,7 +41236,7 @@ export default {
     '/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).',
+          'Removes a specified [access system 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: {
@@ -40977,12 +41244,14 @@ export default {
               schema: {
                 properties: {
                   acs_user_id: {
-                    description: 'ID of the ACS user.',
+                    description:
+                      'ID of the access system user that you want to remove from the user identity..',
                     format: 'uuid',
                     type: 'string',
                   },
                   user_identity_id: {
-                    description: 'ID of the desired user identity.',
+                    description:
+                      'ID of the user identity from which you want to remove an access system user.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -41033,12 +41302,14 @@ export default {
               schema: {
                 properties: {
                   device_id: {
-                    description: 'ID of the desired managed device.',
+                    description:
+                      'ID of the managed device to which you want to revoke access from the user identity.',
                     format: 'uuid',
                     type: 'string',
                   },
                   user_identity_id: {
-                    description: 'ID of the desired user identity.',
+                    description:
+                      'ID of the user identity from which you want to revoke access to a device.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -41080,6 +41351,8 @@ export default {
     },
     '/user_identities/update': {
       patch: {
+        description:
+          'Updates 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: 'userIdentitiesUpdatePatch',
         requestBody: {
           content: {
@@ -41092,15 +41365,21 @@ export default {
                     nullable: true,
                     type: 'string',
                   },
-                  full_name: { minLength: 1, nullable: true, type: 'string' },
-                  phone_number: {
+                  full_name: {
                     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).',
+                      '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.',
                     nullable: true,
                     type: 'string',
                   },
                   user_identity_id: {
-                    description: 'ID of the user identity.',
+                    description:
+                      'ID of the user identity that you want to update.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -41145,6 +41424,8 @@ export default {
         'x-title': 'Update a User Identity',
       },
       post: {
+        description:
+          'Updates 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: 'userIdentitiesUpdatePost',
         requestBody: {
           content: {
@@ -41157,15 +41438,21 @@ export default {
                     nullable: true,
                     type: 'string',
                   },
-                  full_name: { minLength: 1, nullable: true, type: 'string' },
-                  phone_number: {
+                  full_name: {
                     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).',
+                      '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.',
                     nullable: true,
                     type: 'string',
                   },
                   user_identity_id: {
-                    description: 'ID of the user identity.',
+                    description:
+                      'ID of the user identity that you want to update.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -41213,6 +41500,8 @@ export default {
     },
     '/webhooks/create': {
       post: {
+        description:
+          'Creates a new [webhook](https://docs.seam.co/latest/developer-tools/webhooks).',
         operationId: 'webhooksCreatePost',
         requestBody: {
           content: {
@@ -41221,10 +41510,16 @@ export default {
                 properties: {
                   event_types: {
                     default: ['*'],
+                    description:
+                      'Types of events that you want the new webhook to receive.',
                     items: { type: 'string' },
                     type: 'array',
                   },
-                  url: { format: 'uri', type: 'string' },
+                  url: {
+                    description: 'URL for the new webhook.',
+                    format: 'uri',
+                    type: 'string',
+                  },
                 },
                 required: ['url'],
                 type: 'object',
@@ -41262,16 +41557,24 @@ export default {
         'x-fern-sdk-method-name': 'create',
         'x-fern-sdk-return-value': 'webhook',
         'x-response-key': 'webhook',
+        'x-title': 'Create a Webhook',
       },
     },
     '/webhooks/delete': {
       post: {
+        description:
+          'Deletes a specified [webhook](https://docs.seam.co/latest/developer-tools/webhooks).',
         operationId: 'webhooksDeletePost',
         requestBody: {
           content: {
             'application/json': {
               schema: {
-                properties: { webhook_id: { type: 'string' } },
+                properties: {
+                  webhook_id: {
+                    description: 'ID of the webhook that you want to delete.',
+                    type: 'string',
+                  },
+                },
                 required: ['webhook_id'],
                 type: 'object',
               },
@@ -41304,16 +41607,24 @@ export default {
         'x-fern-sdk-group-name': ['webhooks'],
         'x-fern-sdk-method-name': 'delete',
         'x-response-key': null,
+        'x-title': 'Delete a Webhook',
       },
     },
     '/webhooks/get': {
       post: {
+        description:
+          'Gets a specified [webhook](https://docs.seam.co/latest/developer-tools/webhooks).',
         operationId: 'webhooksGetPost',
         requestBody: {
           content: {
             'application/json': {
               schema: {
-                properties: { webhook_id: { type: 'string' } },
+                properties: {
+                  webhook_id: {
+                    description: 'ID of the webhook that you want to get.',
+                    type: 'string',
+                  },
+                },
                 required: ['webhook_id'],
                 type: 'object',
               },
@@ -41350,10 +41661,13 @@ export default {
         'x-fern-sdk-method-name': 'get',
         'x-fern-sdk-return-value': 'webhook',
         'x-response-key': 'webhook',
+        'x-title': 'Get a Webhook',
       },
     },
     '/webhooks/list': {
       get: {
+        description:
+          'Returns a list of all [webhooks](https://docs.seam.co/latest/developer-tools/webhooks).',
         operationId: 'webhooksListGet',
         responses: {
           200: {
@@ -41386,8 +41700,11 @@ export default {
         tags: ['/webhooks'],
         'x-fern-ignore': true,
         'x-response-key': 'webhooks',
+        'x-title': 'List Webhooks',
       },
       post: {
+        description:
+          'Returns a list of all [webhooks](https://docs.seam.co/latest/developer-tools/webhooks).',
         operationId: 'webhooksListPost',
         responses: {
           200: {
@@ -41422,18 +41739,29 @@ export default {
         'x-fern-sdk-method-name': 'list',
         'x-fern-sdk-return-value': 'webhooks',
         'x-response-key': 'webhooks',
+        'x-title': 'List Webhooks',
       },
     },
     '/webhooks/update': {
       post: {
+        description:
+          'Updates a specified [webhook](https://docs.seam.co/latest/developer-tools/webhooks).',
         operationId: 'webhooksUpdatePost',
         requestBody: {
           content: {
             'application/json': {
               schema: {
                 properties: {
-                  event_types: { items: { type: 'string' }, type: 'array' },
-                  webhook_id: { type: 'string' },
+                  event_types: {
+                    description:
+                      'Types of events that you want the webhook to receive.',
+                    items: { type: 'string' },
+                    type: 'array',
+                  },
+                  webhook_id: {
+                    description: 'ID of the webhook that you want to update.',
+                    type: 'string',
+                  },
                 },
                 required: ['webhook_id', 'event_types'],
                 type: 'object',
@@ -41467,16 +41795,27 @@ export default {
         'x-fern-sdk-group-name': ['webhooks'],
         'x-fern-sdk-method-name': 'update',
         'x-response-key': null,
+        'x-title': 'Update a Webhook',
       },
       put: {
+        description:
+          'Updates a specified [webhook](https://docs.seam.co/latest/developer-tools/webhooks).',
         operationId: 'webhooksUpdatePut',
         requestBody: {
           content: {
             'application/json': {
               schema: {
                 properties: {
-                  event_types: { items: { type: 'string' }, type: 'array' },
-                  webhook_id: { type: 'string' },
+                  event_types: {
+                    description:
+                      'Types of events that you want the webhook to receive.',
+                    items: { type: 'string' },
+                    type: 'array',
+                  },
+                  webhook_id: {
+                    description: 'ID of the webhook that you want to update.',
+                    type: 'string',
+                  },
                 },
                 required: ['webhook_id', 'event_types'],
                 type: 'object',
@@ -41509,41 +41848,72 @@ export default {
         tags: ['/webhooks'],
         'x-fern-ignore': true,
         'x-response-key': null,
+        'x-title': 'Update a Webhook',
       },
     },
     '/workspaces/create': {
       post: {
+        description:
+          'Creates a new [workspace](https://docs.seam.co/latest/core-concepts/workspaces).',
         operationId: 'workspacesCreatePost',
         requestBody: {
           content: {
             'application/json': {
               schema: {
                 properties: {
-                  company_name: { type: 'string' },
+                  company_name: {
+                    description: 'Company name for the new workspace.',
+                    type: 'string',
+                  },
                   connect_partner_name: {
                     deprecated: true,
+                    description: 'Connect partner name for the new workspace.',
                     nullable: true,
                     type: 'string',
                     'x-deprecated': 'use company_name',
                   },
                   connect_webview_customization: {
+                    description:
+                      '[Connect Webview](https://docs.seam.co/latest/core-concepts/connect-webviews) customizations for the new workspace. See also [Customize the Look and Feel of Your Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-look-and-feel-of-your-connect-webviews).',
                     properties: {
                       logo_shape: {
+                        description:
+                          'Logo shape for [Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews) in the new workspace. See also [Customize the Look and Feel of Your Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-look-and-feel-of-your-connect-webviews).',
                         enum: ['circle', 'square'],
                         nullable: true,
                         type: 'string',
                       },
-                      primary_button_color: { nullable: true, type: 'string' },
+                      primary_button_color: {
+                        description:
+                          'Primary button color for [Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews) in the new workspace. See also [Customize the Look and Feel of Your Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-look-and-feel-of-your-connect-webviews).',
+                        nullable: true,
+                        type: 'string',
+                      },
                       primary_button_text_color: {
+                        description:
+                          'Primary button text color for [Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews) in the new workspace. See also [Customize the Look and Feel of Your Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-look-and-feel-of-your-connect-webviews).',
+                        nullable: true,
+                        type: 'string',
+                      },
+                      success_message: {
+                        description:
+                          'Success message for [Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews) in the new workspace. See also [Customize the Look and Feel of Your Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-look-and-feel-of-your-connect-webviews).',
                         nullable: true,
                         type: 'string',
                       },
-                      success_message: { nullable: true, type: 'string' },
                     },
                     type: 'object',
                   },
-                  is_sandbox: { default: false, type: 'boolean' },
-                  name: { type: 'string' },
+                  is_sandbox: {
+                    default: false,
+                    description:
+                      'Indicates whether the new workspace is a [sandbox workspace](https://docs.seam.co/latest/core-concepts/workspaces#sandbox-workspaces).',
+                    type: 'boolean',
+                  },
+                  name: {
+                    description: 'Name of the new workspace.',
+                    type: 'string',
+                  },
                   webview_logo_shape: {
                     deprecated: true,
                     enum: ['circle', 'square'],
@@ -41606,10 +41976,13 @@ export default {
         'x-fern-sdk-method-name': 'create',
         'x-fern-sdk-return-value': 'workspace',
         'x-response-key': 'workspace',
+        'x-title': 'Create a Workspace',
       },
     },
     '/workspaces/get': {
       get: {
+        description:
+          'Returns the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) associated with the authentication value.',
         operationId: 'workspacesGetGet',
         responses: {
           200: {
@@ -41634,14 +42007,18 @@ export default {
           { api_key: [] },
           { console_session_with_workspace: [] },
           { client_session: [] },
+          { client_session_with_customer: [] },
           { pat_with_workspace: [] },
         ],
         summary: '/workspaces/get',
         tags: ['/workspaces'],
         'x-fern-ignore': true,
         'x-response-key': 'workspace',
+        'x-title': 'Get a Workspace',
       },
       post: {
+        description:
+          'Returns the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) associated with the authentication value.',
         operationId: 'workspacesGetPost',
         responses: {
           200: {
@@ -41666,6 +42043,7 @@ export default {
           { api_key: [] },
           { console_session_with_workspace: [] },
           { client_session: [] },
+          { client_session_with_customer: [] },
           { pat_with_workspace: [] },
         ],
         summary: '/workspaces/get',
@@ -41674,10 +42052,13 @@ export default {
         'x-fern-sdk-method-name': 'get',
         'x-fern-sdk-return-value': 'workspace',
         'x-response-key': 'workspace',
+        'x-title': 'Get a Workspace',
       },
     },
     '/workspaces/list': {
       get: {
+        description:
+          'Returns a list of [workspaces](https://docs.seam.co/latest/core-concepts/workspaces) associated with the authentication value.',
         operationId: 'workspacesListGet',
         responses: {
           200: {
@@ -41713,8 +42094,11 @@ export default {
         tags: ['/workspaces'],
         'x-fern-ignore': true,
         'x-response-key': 'workspaces',
+        'x-title': 'List Workspaces',
       },
       post: {
+        description:
+          'Returns a list of [workspaces](https://docs.seam.co/latest/core-concepts/workspaces) associated with the authentication value.',
         operationId: 'workspacesListPost',
         responses: {
           200: {
@@ -41752,12 +42136,13 @@ export default {
         'x-fern-sdk-method-name': 'list',
         'x-fern-sdk-return-value': 'workspaces',
         'x-response-key': 'workspaces',
+        'x-title': 'List Workspaces',
       },
     },
     '/workspaces/reset_sandbox': {
       post: {
         description:
-          'Resets a [sandbox workspace](https://docs.seam.co/latest/core-concepts/workspaces#sandbox-workspaces). Note that this endpoint is only available for sandbox workspaces.',
+          'Resets the [sandbox workspace](https://docs.seam.co/latest/core-concepts/workspaces#sandbox-workspaces) associated with the authentication value. Note that this endpoint is only available for sandbox workspaces.',
         operationId: 'workspacesResetSandboxPost',
         responses: {
           200: {
@@ -41792,35 +42177,64 @@ export default {
         'x-fern-sdk-method-name': 'reset_sandbox',
         'x-fern-sdk-return-value': 'action_attempt',
         'x-response-key': 'action_attempt',
+        'x-title': 'Reset a Sandbox Workspace',
       },
     },
     '/workspaces/update': {
       patch: {
+        description:
+          'Updates the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) associated with the authentication value.',
         operationId: 'workspacesUpdatePatch',
         requestBody: {
           content: {
             'application/json': {
               schema: {
                 properties: {
-                  connect_partner_name: { type: 'string' },
+                  connect_partner_name: {
+                    description: 'Connect partner name for the workspace.',
+                    type: 'string',
+                  },
                   connect_webview_customization: {
+                    description:
+                      '[Connect Webview](https://docs.seam.co/latest/core-concepts/connect-webviews) customizations for the workspace. See also [Customize the Look and Feel of Your Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-look-and-feel-of-your-connect-webviews).',
                     properties: {
                       logo_shape: {
+                        description:
+                          'Logo shape for [Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews) in the workspace. See also [Customize the Look and Feel of Your Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-look-and-feel-of-your-connect-webviews).',
                         enum: ['circle', 'square'],
                         nullable: true,
                         type: 'string',
                       },
-                      primary_button_color: { nullable: true, type: 'string' },
+                      primary_button_color: {
+                        description:
+                          'Primary button color for [Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews) in the workspace. See also [Customize the Look and Feel of Your Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-look-and-feel-of-your-connect-webviews).',
+                        nullable: true,
+                        type: 'string',
+                      },
                       primary_button_text_color: {
+                        description:
+                          'Primary button text color for [Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews) in the workspace. See also [Customize the Look and Feel of Your Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-look-and-feel-of-your-connect-webviews).',
+                        nullable: true,
+                        type: 'string',
+                      },
+                      success_message: {
+                        description:
+                          'Success message for [Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews) in the workspace. See also [Customize the Look and Feel of Your Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-look-and-feel-of-your-connect-webviews).',
                         nullable: true,
                         type: 'string',
                       },
-                      success_message: { nullable: true, type: 'string' },
                     },
                     type: 'object',
                   },
-                  is_suspended: { type: 'boolean' },
-                  name: { type: 'string' },
+                  is_suspended: {
+                    description:
+                      'Indicates whether the workspace is suspended.',
+                    type: 'boolean',
+                  },
+                  name: {
+                    description: 'Name of the workspace.',
+                    type: 'string',
+                  },
                 },
                 type: 'object',
               },
@@ -41841,33 +42255,62 @@ export default {
         tags: ['/workspaces'],
         'x-fern-ignore': true,
         'x-response-key': null,
+        'x-title': 'Udpate a Workspace',
       },
       post: {
+        description:
+          'Updates the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) associated with the authentication value.',
         operationId: 'workspacesUpdatePost',
         requestBody: {
           content: {
             'application/json': {
               schema: {
                 properties: {
-                  connect_partner_name: { type: 'string' },
+                  connect_partner_name: {
+                    description: 'Connect partner name for the workspace.',
+                    type: 'string',
+                  },
                   connect_webview_customization: {
+                    description:
+                      '[Connect Webview](https://docs.seam.co/latest/core-concepts/connect-webviews) customizations for the workspace. See also [Customize the Look and Feel of Your Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-look-and-feel-of-your-connect-webviews).',
                     properties: {
                       logo_shape: {
+                        description:
+                          'Logo shape for [Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews) in the workspace. See also [Customize the Look and Feel of Your Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-look-and-feel-of-your-connect-webviews).',
                         enum: ['circle', 'square'],
                         nullable: true,
                         type: 'string',
                       },
-                      primary_button_color: { nullable: true, type: 'string' },
+                      primary_button_color: {
+                        description:
+                          'Primary button color for [Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews) in the workspace. See also [Customize the Look and Feel of Your Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-look-and-feel-of-your-connect-webviews).',
+                        nullable: true,
+                        type: 'string',
+                      },
                       primary_button_text_color: {
+                        description:
+                          'Primary button text color for [Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews) in the workspace. See also [Customize the Look and Feel of Your Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-look-and-feel-of-your-connect-webviews).',
+                        nullable: true,
+                        type: 'string',
+                      },
+                      success_message: {
+                        description:
+                          'Success message for [Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews) in the workspace. See also [Customize the Look and Feel of Your Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-look-and-feel-of-your-connect-webviews).',
                         nullable: true,
                         type: 'string',
                       },
-                      success_message: { nullable: true, type: 'string' },
                     },
                     type: 'object',
                   },
-                  is_suspended: { type: 'boolean' },
-                  name: { type: 'string' },
+                  is_suspended: {
+                    description:
+                      'Indicates whether the workspace is suspended.',
+                    type: 'boolean',
+                  },
+                  name: {
+                    description: 'Name of the workspace.',
+                    type: 'string',
+                  },
                 },
                 type: 'object',
               },
@@ -41889,6 +42332,7 @@ export default {
         'x-fern-sdk-group-name': ['workspaces'],
         'x-fern-sdk-method-name': 'update',
         'x-response-key': null,
+        'x-title': 'Udpate a Workspace',
       },
     },
   },