seam 2.131.0 → 2.133.0

data/lib/seam/routes/devices.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+module Seam
+  module Clients
+    class Devices
+      def initialize(client:, defaults:)
+        @client = client
+        @defaults = defaults
+      end
+
+      def simulate
+        @simulate ||= Seam::Clients::DevicesSimulate.new(client: @client, defaults: @defaults)
+      end
+
+      def unmanaged
+        @unmanaged ||= Seam::Clients::DevicesUnmanaged.new(client: @client, defaults: @defaults)
+      end
+
+      # Returns a specified [device](https://docs.seam.co/core-concepts/devices).
+      #
+      # You must specify either `device_id` or `name`.
+      # @param device_id ID of the device that you want to get.
+      # @param name Name of the device that you want to get.
+      # @return [Seam::Resources::Device] OK
+      def get(device_id: nil, name: nil)
+        res = @client.post("/devices/get", {device_id: device_id, name: name}.compact)
+
+        Seam::Resources::Device.load_from_response(res.body["device"])
+      end
+
+      # Returns a list of all [devices](https://docs.seam.co/core-concepts/devices).
+      # @param connect_webview_id ID of the Connect Webview for which you want to list devices.
+      # @param connected_account_id ID of the connected account for which you want to list devices.
+      # @param connected_account_ids Array of IDs of the connected accounts for which you want to list devices.
+      # @param created_before Timestamp by which to limit returned devices. Returns devices created before this timestamp.
+      # @param custom_metadata_has Set of key:value [custom metadata](https://docs.seam.co/core-concepts/devices/adding-custom-metadata-to-a-device) pairs for which you want to list devices.
+      # @param customer_key Customer key for which you want to list devices.
+      # @param device_ids Array of device IDs for which you want to list devices.
+      # @param device_type Device type for which you want to list devices.
+      # @param device_types Array of device types for which you want to list devices.
+      # @param limit Numerical limit on the number of devices to return.
+      # @param manufacturer Manufacturer for which you want to list devices.
+      # @param page_cursor Identifies the specific page of results to return, obtained from the previous page's `next_page_cursor`.
+      # @param search String for which to search. Filters returned devices to include all records that satisfy a partial match using `device_id` (full or partial UUID prefix, minimum 4 characters), `connected_account_id`, `display_name`, `custom_metadata` or `location.location_name`.
+      # @param space_id ID of the space for which you want to list devices.
+      # @param unstable_location_id
+      # @deprecated unstable_location_id: Use `space_id`.
+      # @param user_identifier_key Your own internal user ID for the user for which you want to list devices.
+      # @return [Seam::Resources::Device] OK
+      def list(connect_webview_id: nil, connected_account_id: nil, connected_account_ids: nil, created_before: nil, custom_metadata_has: nil, customer_key: nil, device_ids: nil, device_type: nil, device_types: nil, limit: nil, manufacturer: nil, page_cursor: nil, search: nil, space_id: nil, unstable_location_id: nil, user_identifier_key: nil)
+        res = @client.post("/devices/list", {connect_webview_id: connect_webview_id, connected_account_id: connected_account_id, connected_account_ids: connected_account_ids, created_before: created_before, custom_metadata_has: custom_metadata_has, customer_key: customer_key, device_ids: device_ids, device_type: device_type, device_types: device_types, limit: limit, manufacturer: manufacturer, page_cursor: page_cursor, search: search, space_id: space_id, unstable_location_id: unstable_location_id, user_identifier_key: user_identifier_key}.compact)
+
+        Seam::Resources::Device.load_from_response(res.body["devices"])
+      end
+
+      # Returns a list of all device providers.
+      #
+      # The information that this endpoint returns for each provider includes a set of [capability flags](https://docs.seam.co/capability-guides/device-and-system-capabilities#capability-flags), such as `device_provider.can_remotely_unlock`. If at least one supported device from a provider has a specific capability, the corresponding capability flag is `true`.
+      #
+      # When you create a [Connect Webview](https://docs.seam.co/core-concepts/connect-webviews), you can customize the providers—that is, the brands—that it displays. In the `/connect_webviews/create` request, include the desired set of device provider keys in the `accepted_providers` parameter. See also [Customize the Brands to Display in Your Connect Webviews](https://docs.seam.co/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-brands-to-display-in-your-connect-webviews).
+      # @param provider_category Category for which you want to list providers.
+      # @return [Seam::Resources::DeviceProvider] OK
+      def list_device_providers(provider_category: nil)
+        res = @client.post("/devices/list_device_providers", {provider_category: provider_category}.compact)
+
+        Seam::Resources::DeviceProvider.load_from_response(res.body["device_providers"])
+      end
+
+      # Updates provider-specific metadata for devices.
+      # @param devices Array of devices with provider metadata to update
+      # @return [nil] OK
+      def report_provider_metadata(devices:)
+        @client.post("/devices/report_provider_metadata", {devices: devices}.compact)
+
+        nil
+      end
+
+      # Updates a specified [device](https://docs.seam.co/core-concepts/devices).
+      #
+      # You can add or change [custom metadata](https://docs.seam.co/core-concepts/devices/adding-custom-metadata-to-a-device) for a device, change the device's name, or [convert a managed device to unmanaged](https://docs.seam.co/core-concepts/devices/managed-and-unmanaged-devices).
+      # @param device_id ID of the device that you want to update.
+      # @param backup_access_code_pool_enabled Indicates whether the device's [backup access code pool](https://docs.seam.co/low-level-apis/smart-locks/access-codes/backup-access-codes) is enabled. Set to `false` to disable the pool: Seam stops refilling it and removes any backup codes that have not yet been pulled into active use.
+      # @param custom_metadata Custom metadata that you want to associate with the device. Supports up to 50 JSON key:value pairs. [Adding custom metadata to a device](https://docs.seam.co/core-concepts/devices/adding-custom-metadata-to-a-device) enables you to store custom information, like customer details or internal IDs from your application. Then, you can [filter devices by the desired metadata](https://docs.seam.co/core-concepts/devices/filtering-devices-by-custom-metadata).
+      # @param is_managed Indicates whether the device is managed. To unmanage a device, set `is_managed` to `false`.
+      # @param name Name for the device.
+      # @param properties
+      # @return [nil] OK
+      def update(device_id:, backup_access_code_pool_enabled: nil, custom_metadata: nil, is_managed: nil, name: nil, properties: nil)
+        @client.post("/devices/update", {device_id: device_id, backup_access_code_pool_enabled: backup_access_code_pool_enabled, custom_metadata: custom_metadata, is_managed: is_managed, name: name, properties: properties}.compact)
+
+        nil
+      end
+    end
+  end
+end

data/lib/seam/routes/devices_simulate.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Seam
+  module Clients
+    class DevicesSimulate
+      def initialize(client:, defaults:)
+        @client = client
+        @defaults = defaults
+      end
+
+      # Simulates connecting a device to Seam. Only applicable for [sandbox devices](https://docs.seam.co/core-concepts/workspaces#sandbox-workspaces). See also [Testing Your App Against Device Disconnection and Removal](https://docs.seam.co/core-concepts/devices/testing-your-app-against-device-disconnection-and-removal).
+      # @param device_id ID of the device that you want to simulate connecting to Seam.
+      # @return [nil] OK
+      def connect(device_id:)
+        @client.post("/devices/simulate/connect", {device_id: device_id}.compact)
+
+        nil
+      end
+
+      # Simulates bringing the Wi‑Fi hub (bridge) back online for a device.
+      # Only applicable for sandbox workspaces and currently
+      # implemented for August and TTLock locks.
+      # This will clear the `hub_disconnected` error on the device.
+      # @param device_id ID of the device whose hub you want to reconnect.
+      # @return [nil] OK
+      def connect_to_hub(device_id:)
+        @client.post("/devices/simulate/connect_to_hub", {device_id: device_id}.compact)
+
+        nil
+      end
+
+      # Simulates disconnecting a device from Seam. Only applicable for [sandbox devices](https://docs.seam.co/core-concepts/workspaces#sandbox-workspaces). See also [Testing Your App Against Device Disconnection and Removal](https://docs.seam.co/core-concepts/devices/testing-your-app-against-device-disconnection-and-removal).
+      # @param device_id ID of the device that you want to simulate disconnecting from Seam.
+      # @return [nil] OK
+      def disconnect(device_id:)
+        @client.post("/devices/simulate/disconnect", {device_id: device_id}.compact)
+
+        nil
+      end
+
+      # Simulates taking the Wi‑Fi hub (bridge) offline for a device.
+      # Only applicable for sandbox workspaces and currently
+      # implemented for August, TTLock, and IglooHome devices.
+      # This will set the `hub_disconnected` error on the device, or mark the
+      # IglooHome bridge offline in sandbox.
+      # @param device_id ID of the device whose hub you want to disconnect.
+      # @return [nil] OK
+      def disconnect_from_hub(device_id:)
+        @client.post("/devices/simulate/disconnect_from_hub", {device_id: device_id}.compact)
+
+        nil
+      end
+
+      # Toggle the simulated Nuki Smart Hosting subscription for a device (sandbox only).
+      # Send `is_expired: true` to simulate an expired subscription, or `false` to simulate an active subscription.
+      # The actual device error is created/cleared by the poller after this state change.
+      # @param device_id
+      # @param is_expired
+      # @return [nil] OK
+      def paid_subscription(device_id:, is_expired:)
+        @client.post("/devices/simulate/paid_subscription", {device_id: device_id, is_expired: is_expired}.compact)
+
+        nil
+      end
+
+      # Simulates removing a device from Seam. Only applicable for [sandbox devices](https://docs.seam.co/core-concepts/workspaces#sandbox-workspaces). See also [Testing Your App Against Device Disconnection and Removal](https://docs.seam.co/core-concepts/devices/testing-your-app-against-device-disconnection-and-removal).
+      # @param device_id ID of the device that you want to simulate removing from Seam.
+      # @return [nil] OK
+      def remove(device_id:)
+        @client.post("/devices/simulate/remove", {device_id: device_id}.compact)
+
+        nil
+      end
+    end
+  end
+end

data/lib/seam/routes/devices_unmanaged.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Seam
+  module Clients
+    class DevicesUnmanaged
+      def initialize(client:, defaults:)
+        @client = client
+        @defaults = defaults
+      end
+
+      # Returns a specified [unmanaged device](https://docs.seam.co/core-concepts/devices/managed-and-unmanaged-devices).
+      #
+      # An unmanaged device has a limited set of visible properties and a subset of supported events. You cannot control an unmanaged device. Any [access codes](https://docs.seam.co/low-level-apis/smart-locks/access-codes/migrating-existing-access-codes) on an unmanaged device are unmanaged. To control an unmanaged device with Seam, [convert it to a managed device](https://docs.seam.co/core-concepts/devices/managed-and-unmanaged-devices#convert-an-unmanaged-device-to-managed).
+      #
+      # You must specify either `device_id` or `name`.
+      # @param device_id ID of the unmanaged device that you want to get.
+      # @param name Name of the unmanaged device that you want to get.
+      # @return [Seam::Resources::UnmanagedDevice] OK
+      def get(device_id: nil, name: nil)
+        res = @client.post("/devices/unmanaged/get", {device_id: device_id, name: name}.compact)
+
+        Seam::Resources::UnmanagedDevice.load_from_response(res.body["device"])
+      end
+
+      # Returns a list of all [unmanaged devices](https://docs.seam.co/core-concepts/devices/managed-and-unmanaged-devices).
+      #
+      # An unmanaged device has a limited set of visible properties and a subset of supported events. You cannot control an unmanaged device. Any [access codes](https://docs.seam.co/low-level-apis/smart-locks/access-codes/migrating-existing-access-codes) on an unmanaged device are unmanaged. To control an unmanaged device with Seam, [convert it to a managed device](https://docs.seam.co/core-concepts/devices/managed-and-unmanaged-devices#convert-an-unmanaged-device-to-managed).
+      # @param connect_webview_id ID of the Connect Webview for which you want to list devices.
+      # @param connected_account_id ID of the connected account for which you want to list devices.
+      # @param connected_account_ids Array of IDs of the connected accounts for which you want to list devices.
+      # @param created_before Timestamp by which to limit returned devices. Returns devices created before this timestamp.
+      # @param custom_metadata_has Set of key:value [custom metadata](https://docs.seam.co/core-concepts/devices/adding-custom-metadata-to-a-device) pairs for which you want to list devices.
+      # @param customer_key Customer key for which you want to list devices.
+      # @param device_ids Array of device IDs for which you want to list devices.
+      # @param device_type Device type for which you want to list devices.
+      # @param device_types Array of device types for which you want to list devices.
+      # @param limit Numerical limit on the number of devices to return.
+      # @param manufacturer Manufacturer for which you want to list devices.
+      # @param page_cursor Identifies the specific page of results to return, obtained from the previous page's `next_page_cursor`.
+      # @param search String for which to search. Filters returned devices to include all records that satisfy a partial match using `device_id` (full or partial UUID prefix, minimum 4 characters), `connected_account_id`, `display_name`, `custom_metadata` or `location.location_name`.
+      # @param space_id ID of the space for which you want to list devices.
+      # @param unstable_location_id
+      # @deprecated unstable_location_id: Use `space_id`.
+      # @param user_identifier_key Your own internal user ID for the user for which you want to list devices.
+      # @return [Seam::Resources::UnmanagedDevice] OK
+      def list(connect_webview_id: nil, connected_account_id: nil, connected_account_ids: nil, created_before: nil, custom_metadata_has: nil, customer_key: nil, device_ids: nil, device_type: nil, device_types: nil, limit: nil, manufacturer: nil, page_cursor: nil, search: nil, space_id: nil, unstable_location_id: nil, user_identifier_key: nil)
+        res = @client.post("/devices/unmanaged/list", {connect_webview_id: connect_webview_id, connected_account_id: connected_account_id, connected_account_ids: connected_account_ids, created_before: created_before, custom_metadata_has: custom_metadata_has, customer_key: customer_key, device_ids: device_ids, device_type: device_type, device_types: device_types, limit: limit, manufacturer: manufacturer, page_cursor: page_cursor, search: search, space_id: space_id, unstable_location_id: unstable_location_id, user_identifier_key: user_identifier_key}.compact)
+
+        Seam::Resources::UnmanagedDevice.load_from_response(res.body["devices"])
+      end
+
+      # Updates a specified [unmanaged device](https://docs.seam.co/core-concepts/devices/managed-and-unmanaged-devices). To convert an unmanaged device to managed, set `is_managed` to `true`.
+      #
+      # An unmanaged device has a limited set of visible properties and a subset of supported events. You cannot control an unmanaged device. Any [access codes](https://docs.seam.co/low-level-apis/smart-locks/access-codes/migrating-existing-access-codes) on an unmanaged device are unmanaged. To control an unmanaged device with Seam, [convert it to a managed device](https://docs.seam.co/core-concepts/devices/managed-and-unmanaged-devices#convert-an-unmanaged-device-to-managed).
+      # @param device_id ID of the unmanaged device that you want to update.
+      # @param custom_metadata Custom metadata that you want to associate with the device. Supports up to 50 JSON key:value pairs.
+      # @param is_managed Indicates whether the device is managed. Set this parameter to `true` to convert an unmanaged device to managed.
+      # @return [nil] OK
+      def update(device_id:, custom_metadata: nil, is_managed: nil)
+        @client.post("/devices/unmanaged/update", {device_id: device_id, custom_metadata: custom_metadata, is_managed: is_managed}.compact)
+
+        nil
+      end
+    end
+  end
+end

data/lib/seam/routes/events.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module Seam
+  module Clients
+    class Events
+      def initialize(client:, defaults:)
+        @client = client
+        @defaults = defaults
+      end
+
+      # Returns a specified event. This endpoint returns the same event that would be sent to a [webhook](https://docs.seam.co/developer-tools/webhooks), but it enables you to retrieve an event that already took place.
+      # @param event_id Unique identifier for the event that you want to get.
+      # @param device_id Unique identifier for the device that triggered the event that you want to get.
+      # @param event_type Type of the event that you want to get.
+      # @return [Seam::Resources::SeamEvent] OK
+      def get(event_id: nil, device_id: nil, event_type: nil)
+        res = @client.post("/events/get", {event_id: event_id, device_id: device_id, event_type: event_type}.compact)
+
+        Seam::Resources::SeamEvent.load_from_response(res.body["event"])
+      end
+
+      # Returns a list of all events. This endpoint returns the same events that would be sent to a [webhook](https://docs.seam.co/developer-tools/webhooks), but it enables you to filter or see events that already took place.
+      # @param access_code_id ID of the access code for which you want to list events.
+      # @param access_code_ids IDs of the access codes for which you want to list events.
+      # @param access_grant_id ID of the access grant for which you want to list events.
+      # @param access_grant_ids IDs of the access grants for which you want to list events.
+      # @param access_method_id ID of the access method for which you want to list events.
+      # @param access_method_ids IDs of the access methods for which you want to list events.
+      # @param acs_access_group_id ID of the ACS access group for which you want to list events.
+      # @param acs_credential_id ID of the ACS credential for which you want to list events.
+      # @param acs_encoder_id ID of the ACS encoder for which you want to list events.
+      # @param acs_entrance_id ID of the ACS entrance for which you want to list events.
+      # @param acs_system_id ID of the access system for which you want to list events.
+      # @param acs_system_ids IDs of the access systems for which you want to list events.
+      # @param acs_user_id ID of the ACS user for which you want to list events.
+      # @param between Lower and upper timestamps to define an exclusive interval containing the events that you want to list. You must include `since` or `between`.
+      # @param connect_webview_id ID of the Connect Webview for which you want to list events.
+      # @param connected_account_id ID of the connected account for which you want to list events.
+      # @param customer_key Customer key for which you want to list events.
+      # @param device_id ID of the device for which you want to list events.
+      # @param device_ids IDs of the devices for which you want to list events.
+      # @param event_ids IDs of the events that you want to list.
+      # @param event_type Type of the events that you want to list.
+      # @param event_types Types of the events that you want to list.
+      # @param limit Numerical limit on the number of events to return.
+      # @param since Timestamp to indicate the beginning generation time for the events that you want to list. You must include `since` or `between`.
+      # @param space_id ID of the space for which you want to list events.
+      # @param space_ids IDs of the spaces for which you want to list events.
+      # @param unstable_offset Offset for the events that you want to list.
+      # @param user_identity_id ID of the user identity for which you want to list events.
+      # @return [Seam::Resources::SeamEvent] OK
+      def list(access_code_id: nil, access_code_ids: nil, access_grant_id: nil, access_grant_ids: nil, access_method_id: nil, access_method_ids: nil, acs_access_group_id: nil, acs_credential_id: nil, acs_encoder_id: nil, acs_entrance_id: nil, acs_system_id: nil, acs_system_ids: nil, acs_user_id: nil, between: nil, connect_webview_id: nil, connected_account_id: nil, customer_key: nil, device_id: nil, device_ids: nil, event_ids: nil, event_type: nil, event_types: nil, limit: nil, since: nil, space_id: nil, space_ids: nil, unstable_offset: nil, user_identity_id: nil)
+        res = @client.post("/events/list", {access_code_id: access_code_id, access_code_ids: access_code_ids, access_grant_id: access_grant_id, access_grant_ids: access_grant_ids, access_method_id: access_method_id, access_method_ids: access_method_ids, acs_access_group_id: acs_access_group_id, acs_credential_id: acs_credential_id, acs_encoder_id: acs_encoder_id, acs_entrance_id: acs_entrance_id, acs_system_id: acs_system_id, acs_system_ids: acs_system_ids, acs_user_id: acs_user_id, between: between, connect_webview_id: connect_webview_id, connected_account_id: connected_account_id, customer_key: customer_key, device_id: device_id, device_ids: device_ids, event_ids: event_ids, event_type: event_type, event_types: event_types, limit: limit, since: since, space_id: space_id, space_ids: space_ids, unstable_offset: unstable_offset, user_identity_id: user_identity_id}.compact)
+
+        Seam::Resources::SeamEvent.load_from_response(res.body["events"])
+      end
+    end
+  end
+end

data/lib/seam/routes/{clients/instant_keys.rb → instant_keys.rb}

@@ -8,18 +8,28 @@ module Seam
         @defaults = defaults
       end
 
+      # Deletes a specified [Instant Key](https://docs.seam.co/capability-guides/instant-keys).
+      # @param instant_key_id ID of the Instant Key that you want to delete.
+      # @return [nil] OK
       def delete(instant_key_id:)
         @client.post("/instant_keys/delete", {instant_key_id: instant_key_id}.compact)
 
         nil
       end
 
+      # Gets an [instant key](https://docs.seam.co/capability-guides/instant-keys).
+      # @param instant_key_id ID of the instant key to get.
+      # @param instant_key_url URL of the instant key to get.
+      # @return [Seam::Resources::InstantKey] OK
       def get(instant_key_id: nil, instant_key_url: nil)
         res = @client.post("/instant_keys/get", {instant_key_id: instant_key_id, instant_key_url: instant_key_url}.compact)
 
         Seam::Resources::InstantKey.load_from_response(res.body["instant_key"])
       end
 
+      # Returns a list of all [instant keys](https://docs.seam.co/capability-guides/instant-keys).
+      # @param user_identity_id ID of the user identity by which you want to filter the list of Instant Keys.
+      # @return [Seam::Resources::InstantKey] OK
       def list(user_identity_id: nil)
         res = @client.post("/instant_keys/list", {user_identity_id: user_identity_id}.compact)
 

data/lib/seam/routes/locks.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+require "seam/helpers/action_attempt"
+
+module Seam
+  module Clients
+    class Locks
+      def initialize(client:, defaults:)
+        @client = client
+        @defaults = defaults
+      end
+
+      def simulate
+        @simulate ||= Seam::Clients::LocksSimulate.new(client: @client, defaults: @defaults)
+      end
+
+      # Configures the auto-lock setting for a specified [lock](https://docs.seam.co/low-level-apis/smart-locks).
+      # @param auto_lock_enabled Whether to enable or disable auto-lock.
+      # @param device_id ID of the lock for which you want to configure the auto-lock.
+      # @param auto_lock_delay_seconds Delay in seconds before the lock automatically locks. Required when enabling auto-lock. Must be between 1 and 60.
+      # @return [Seam::Resources::ActionAttempt] OK
+      def configure_auto_lock(auto_lock_enabled:, device_id:, auto_lock_delay_seconds: nil, wait_for_action_attempt: nil)
+        res = @client.post("/locks/configure_auto_lock", {auto_lock_enabled: auto_lock_enabled, device_id: device_id, auto_lock_delay_seconds: auto_lock_delay_seconds}.compact)
+
+        wait_for_action_attempt = wait_for_action_attempt.nil? ? @defaults.wait_for_action_attempt : wait_for_action_attempt
+
+        Helpers::ActionAttempt.decide_and_wait(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
+      end
+
+      # Returns a specified [lock](https://docs.seam.co/low-level-apis/smart-locks).
+      # @param device_id ID of the lock that you want to get.
+      # @param name Name of the lock that you want to get.
+      # @return [Seam::Resources::Device] OK
+      # @deprecated Use `/devices/get` instead.
+      def get(device_id: nil, name: nil)
+        res = @client.post("/locks/get", {device_id: device_id, name: name}.compact)
+
+        Seam::Resources::Device.load_from_response(res.body["device"])
+      end
+
+      # Returns a list of all [locks](https://docs.seam.co/low-level-apis/smart-locks).
+      # @param connect_webview_id ID of the Connect Webview for which you want to list devices.
+      # @param connected_account_id ID of the connected account for which you want to list devices.
+      # @param connected_account_ids Array of IDs of the connected accounts for which you want to list devices.
+      # @param created_before Timestamp by which to limit returned devices. Returns devices created before this timestamp.
+      # @param custom_metadata_has Set of key:value [custom metadata](https://docs.seam.co/core-concepts/devices/adding-custom-metadata-to-a-device) pairs for which you want to list devices.
+      # @param customer_key Customer key for which you want to list devices.
+      # @param device_ids Array of device IDs for which you want to list devices.
+      # @param device_type Device type of the locks that you want to list.
+      # @param device_types Device types of the locks that you want to list.
+      # @param limit Numerical limit on the number of devices to return.
+      # @param manufacturer Manufacturer of the locks that you want to list.
+      # @param page_cursor Identifies the specific page of results to return, obtained from the previous page's `next_page_cursor`.
+      # @param search String for which to search. Filters returned devices to include all records that satisfy a partial match using `device_id` (full or partial UUID prefix, minimum 4 characters), `connected_account_id`, `display_name`, `custom_metadata` or `location.location_name`.
+      # @param space_id ID of the space for which you want to list devices.
+      # @param unstable_location_id
+      # @deprecated unstable_location_id: Use `space_id`.
+      # @param user_identifier_key Your own internal user ID for the user for which you want to list devices.
+      # @return [Seam::Resources::Device] OK
+      def list(connect_webview_id: nil, connected_account_id: nil, connected_account_ids: nil, created_before: nil, custom_metadata_has: nil, customer_key: nil, device_ids: nil, device_type: nil, device_types: nil, limit: nil, manufacturer: nil, page_cursor: nil, search: nil, space_id: nil, unstable_location_id: nil, user_identifier_key: nil)
+        res = @client.post("/locks/list", {connect_webview_id: connect_webview_id, connected_account_id: connected_account_id, connected_account_ids: connected_account_ids, created_before: created_before, custom_metadata_has: custom_metadata_has, customer_key: customer_key, device_ids: device_ids, device_type: device_type, device_types: device_types, limit: limit, manufacturer: manufacturer, page_cursor: page_cursor, search: search, space_id: space_id, unstable_location_id: unstable_location_id, user_identifier_key: user_identifier_key}.compact)
+
+        Seam::Resources::Device.load_from_response(res.body["devices"])
+      end
+
+      # Locks a [lock](https://docs.seam.co/low-level-apis/smart-locks). See also [Locking and Unlocking Smart Locks](https://docs.seam.co/low-level-apis/smart-locks/lock-and-unlock).
+      # @param device_id ID of the lock that you want to lock.
+      # @return [Seam::Resources::ActionAttempt] OK
+      def lock_door(device_id:, wait_for_action_attempt: nil)
+        res = @client.post("/locks/lock_door", {device_id: device_id}.compact)
+
+        wait_for_action_attempt = wait_for_action_attempt.nil? ? @defaults.wait_for_action_attempt : wait_for_action_attempt
+
+        Helpers::ActionAttempt.decide_and_wait(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
+      end
+
+      # Unlocks a [lock](https://docs.seam.co/low-level-apis/smart-locks). See also [Locking and Unlocking Smart Locks](https://docs.seam.co/low-level-apis/smart-locks/lock-and-unlock).
+      # @param device_id ID of the lock that you want to unlock.
+      # @return [Seam::Resources::ActionAttempt] OK
+      def unlock_door(device_id:, wait_for_action_attempt: nil)
+        res = @client.post("/locks/unlock_door", {device_id: device_id}.compact)
+
+        wait_for_action_attempt = wait_for_action_attempt.nil? ? @defaults.wait_for_action_attempt : wait_for_action_attempt
+
+        Helpers::ActionAttempt.decide_and_wait(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
+      end
+    end
+  end
+end

data/lib/seam/routes/{clients/locks_simulate.rb → locks_simulate.rb}

@@ -10,6 +10,10 @@ module Seam
         @defaults = defaults
       end
 
+      # Simulates the entry of a code on a keypad. You can only perform this action for [August](https://docs.seam.co/device-and-system-integration-guides/august-locks) devices within [sandbox workspaces](https://docs.seam.co/core-concepts/workspaces#sandbox-workspaces).
+      # @param code Code that you want to simulate entering on a keypad.
+      # @param device_id ID of the device for which you want to simulate a keypad code entry.
+      # @return [Seam::Resources::ActionAttempt] OK
       def keypad_code_entry(code:, device_id:, wait_for_action_attempt: nil)
         res = @client.post("/locks/simulate/keypad_code_entry", {code: code, device_id: device_id}.compact)
 
@@ -18,6 +22,9 @@ module Seam
         Helpers::ActionAttempt.decide_and_wait(Seam::Resources::ActionAttempt.load_from_response(res.body["action_attempt"]), @client, wait_for_action_attempt)
       end
 
+      # Simulates a manual lock action using a keypad. You can only perform this action for [August](https://docs.seam.co/device-and-system-integration-guides/august-locks) devices within [sandbox workspaces](https://docs.seam.co/core-concepts/workspaces#sandbox-workspaces).
+      # @param device_id ID of the device for which you want to simulate a manual lock action using a keypad.
+      # @return [Seam::Resources::ActionAttempt] OK
       def manual_lock_via_keypad(device_id:, wait_for_action_attempt: nil)
         res = @client.post("/locks/simulate/manual_lock_via_keypad", {device_id: device_id}.compact)
 

data/lib/seam/routes/noise_sensors.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Seam
+  module Clients
+    class NoiseSensors
+      def initialize(client:, defaults:)
+        @client = client
+        @defaults = defaults
+      end
+
+      def noise_thresholds
+        @noise_thresholds ||= Seam::Clients::NoiseSensorsNoiseThresholds.new(client: @client, defaults: @defaults)
+      end
+
+      def simulate
+        @simulate ||= Seam::Clients::NoiseSensorsSimulate.new(client: @client, defaults: @defaults)
+      end
+
+      # Returns a list of all [noise sensors](https://docs.seam.co/capability-guides/noise-sensors).
+      # @param connect_webview_id ID of the Connect Webview for which you want to list devices.
+      # @param connected_account_id ID of the connected account for which you want to list devices.
+      # @param connected_account_ids Array of IDs of the connected accounts for which you want to list devices.
+      # @param created_before Timestamp by which to limit returned devices. Returns devices created before this timestamp.
+      # @param custom_metadata_has Set of key:value [custom metadata](https://docs.seam.co/core-concepts/devices/adding-custom-metadata-to-a-device) pairs for which you want to list devices.
+      # @param customer_key Customer key for which you want to list devices.
+      # @param device_ids Array of device IDs for which you want to list devices.
+      # @param device_type Device type of the noise sensors that you want to list.
+      # @param device_types Device types of the noise sensors that you want to list.
+      # @param limit Numerical limit on the number of devices to return.
+      # @param manufacturer Manufacturers of the noise sensors that you want to list.
+      # @param page_cursor Identifies the specific page of results to return, obtained from the previous page's `next_page_cursor`.
+      # @param search String for which to search. Filters returned devices to include all records that satisfy a partial match using `device_id` (full or partial UUID prefix, minimum 4 characters), `connected_account_id`, `display_name`, `custom_metadata` or `location.location_name`.
+      # @param space_id ID of the space for which you want to list devices.
+      # @param unstable_location_id
+      # @deprecated unstable_location_id: Use `space_id`.
+      # @param user_identifier_key Your own internal user ID for the user for which you want to list devices.
+      # @return [Seam::Resources::Device] OK
+      def list(connect_webview_id: nil, connected_account_id: nil, connected_account_ids: nil, created_before: nil, custom_metadata_has: nil, customer_key: nil, device_ids: nil, device_type: nil, device_types: nil, limit: nil, manufacturer: nil, page_cursor: nil, search: nil, space_id: nil, unstable_location_id: nil, user_identifier_key: nil)
+        res = @client.post("/noise_sensors/list", {connect_webview_id: connect_webview_id, connected_account_id: connected_account_id, connected_account_ids: connected_account_ids, created_before: created_before, custom_metadata_has: custom_metadata_has, customer_key: customer_key, device_ids: device_ids, device_type: device_type, device_types: device_types, limit: limit, manufacturer: manufacturer, page_cursor: page_cursor, search: search, space_id: space_id, unstable_location_id: unstable_location_id, user_identifier_key: user_identifier_key}.compact)
+
+        Seam::Resources::Device.load_from_response(res.body["devices"])
+      end
+    end
+  end
+end

data/lib/seam/routes/noise_sensors_noise_thresholds.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module Seam
+  module Clients
+    class NoiseSensorsNoiseThresholds
+      def initialize(client:, defaults:)
+        @client = client
+        @defaults = defaults
+      end
+
+      # Creates a new [noise threshold](https://docs.seam.co/capability-guides/noise-sensors/configure-noise-threshold-settings) for a [noise sensor](https://docs.seam.co/capability-guides/noise-sensors). Thresholds represent the limits of noise tolerated at a property, which can be customized for each hour of the day. Each device has its own default thresholds, but you can use the Seam API to modify them.
+      # @param device_id ID of the device for which you want to create a noise threshold.
+      # @param ends_daily_at Time at which the new noise threshold should become inactive daily.
+      # @param starts_daily_at Time at which the new noise threshold should become active daily.
+      # @param name Name of the new noise threshold.
+      # @param noise_threshold_decibels Noise level in decibels for the new noise threshold.
+      # @param noise_threshold_nrs Noise level in Noiseaware Noise Risk Score (NRS) for the new noise threshold. This parameter is only relevant for [Noiseaware sensors](https://docs.seam.co/device-and-system-integration-guides/noiseaware-sensors).
+      # @return [Seam::Resources::NoiseThreshold] OK
+      def create(device_id:, ends_daily_at:, starts_daily_at:, name: nil, noise_threshold_decibels: nil, noise_threshold_nrs: nil)
+        res = @client.post("/noise_sensors/noise_thresholds/create", {device_id: device_id, ends_daily_at: ends_daily_at, starts_daily_at: starts_daily_at, name: name, noise_threshold_decibels: noise_threshold_decibels, noise_threshold_nrs: noise_threshold_nrs}.compact)
+
+        Seam::Resources::NoiseThreshold.load_from_response(res.body["noise_threshold"])
+      end
+
+      # Deletes a [noise threshold](https://docs.seam.co/capability-guides/noise-sensors/configure-noise-threshold-settings) from a [noise sensor](https://docs.seam.co/capability-guides/noise-sensors).
+      # @param device_id ID of the device that contains the noise threshold that you want to delete.
+      # @param noise_threshold_id ID of the noise threshold that you want to delete.
+      # @return [nil] OK
+      def delete(device_id:, noise_threshold_id:)
+        @client.post("/noise_sensors/noise_thresholds/delete", {device_id: device_id, noise_threshold_id: noise_threshold_id}.compact)
+
+        nil
+      end
+
+      # Returns a specified [noise threshold](https://docs.seam.co/capability-guides/noise-sensors/configure-noise-threshold-settings) for a [noise sensor](https://docs.seam.co/capability-guides/noise-sensors).
+      # @param noise_threshold_id ID of the noise threshold that you want to get.
+      # @return [Seam::Resources::NoiseThreshold] OK
+      def get(noise_threshold_id:)
+        res = @client.post("/noise_sensors/noise_thresholds/get", {noise_threshold_id: noise_threshold_id}.compact)
+
+        Seam::Resources::NoiseThreshold.load_from_response(res.body["noise_threshold"])
+      end
+
+      # Returns a list of all [noise thresholds](https://docs.seam.co/capability-guides/noise-sensors/configure-noise-threshold-settings) for a [noise sensor](https://docs.seam.co/capability-guides/noise-sensors).
+      # @param device_id ID of the device for which you want to list noise thresholds.
+      # @return [Seam::Resources::NoiseThreshold] OK
+      def list(device_id:)
+        res = @client.post("/noise_sensors/noise_thresholds/list", {device_id: device_id}.compact)
+
+        Seam::Resources::NoiseThreshold.load_from_response(res.body["noise_thresholds"])
+      end
+
+      # Updates a [noise threshold](https://docs.seam.co/capability-guides/noise-sensors/configure-noise-threshold-settings) for a [noise sensor](https://docs.seam.co/capability-guides/noise-sensors).
+      # @param device_id ID of the device that contains the noise threshold that you want to update.
+      # @param noise_threshold_id ID of the noise threshold that you want to update.
+      # @param ends_daily_at Time at which the noise threshold should become inactive daily.
+      # @param name Name of the noise threshold that you want to update.
+      # @param noise_threshold_decibels Noise level in decibels for the noise threshold.
+      # @param noise_threshold_nrs Noise level in Noiseaware Noise Risk Score (NRS) for the noise threshold. This parameter is only relevant for [Noiseaware sensors](https://docs.seam.co/device-and-system-integration-guides/noiseaware-sensors).
+      # @param starts_daily_at Time at which the noise threshold should become active daily.
+      # @return [nil] OK
+      def update(device_id:, noise_threshold_id:, ends_daily_at: nil, name: nil, noise_threshold_decibels: nil, noise_threshold_nrs: nil, starts_daily_at: nil)
+        @client.post("/noise_sensors/noise_thresholds/update", {device_id: device_id, noise_threshold_id: noise_threshold_id, ends_daily_at: ends_daily_at, name: name, noise_threshold_decibels: noise_threshold_decibels, noise_threshold_nrs: noise_threshold_nrs, starts_daily_at: starts_daily_at}.compact)
+
+        nil
+      end
+    end
+  end
+end

data/lib/seam/routes/noise_sensors_simulate.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Seam
+  module Clients
+    class NoiseSensorsSimulate
+      def initialize(client:, defaults:)
+        @client = client
+        @defaults = defaults
+      end
+
+      # Simulates the triggering of a [noise threshold](https://docs.seam.co/capability-guides/noise-sensors/configure-noise-threshold-settings) for a [noise sensor](https://docs.seam.co/capability-guides/noise-sensors) in a [sandbox workspace](https://docs.seam.co/core-concepts/workspaces#sandbox-workspaces).
+      # @param device_id ID of the device for which you want to simulate the triggering of a noise threshold.
+      # @return [nil] OK
+      def trigger_noise_threshold(device_id:)
+        @client.post("/noise_sensors/simulate/trigger_noise_threshold", {device_id: device_id}.compact)
+
+        nil
+      end
+    end
+  end
+end

data/lib/seam/routes/phones.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Seam
+  module Clients
+    class Phones
+      def initialize(client:, defaults:)
+        @client = client
+        @defaults = defaults
+      end
+
+      def simulate
+        @simulate ||= Seam::Clients::PhonesSimulate.new(client: @client, defaults: @defaults)
+      end
+
+      # Deactivates a phone, which is useful, for example, if a user has lost their phone. For more information, see [App User Lost Phone Process](https://docs.seam.co/capability-guides/mobile-access/managing-phones-for-a-user-identity#app-user-lost-phone-process).
+      # @param device_id Device ID of the phone that you want to deactivate.
+      # @return [nil] OK
+      def deactivate(device_id:)
+        @client.post("/phones/deactivate", {device_id: device_id}.compact)
+
+        nil
+      end
+
+      # Returns a specified [phone](https://docs.seam.co/capability-guides/mobile-access/managing-phones-for-a-user-identity).
+      # @param device_id Device ID of the phone that you want to get.
+      # @return [Seam::Resources::Phone] OK
+      def get(device_id:)
+        res = @client.post("/phones/get", {device_id: device_id}.compact)
+
+        Seam::Resources::Phone.load_from_response(res.body["phone"])
+      end
+
+      # Returns a list of all [phones](https://docs.seam.co/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.
+      # @param acs_credential_id ID of the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) by which you want to filter the list of returned phones.
+      # @param owner_user_identity_id ID of the user identity that represents the owner by which you want to filter the list of returned phones.
+      # @return [Seam::Resources::Phone] OK
+      def list(acs_credential_id: nil, owner_user_identity_id: nil)
+        res = @client.post("/phones/list", {acs_credential_id: acs_credential_id, owner_user_identity_id: owner_user_identity_id}.compact)
+
+        Seam::Resources::Phone.load_from_response(res.body["phones"])
+      end
+    end
+  end
+end