seam 2.142.0 → 2.145.0

data/lib/seam/resources/access_code.rb

@@ -39,50 +39,483 @@ module Seam
         attr_accessor :user_level_name
       end
 
+      # Known `error_code` values load as subclasses; unknown values remain Errors instances for forward compatibility.
       class Errors < BaseResource
-        class ModifiedFields < BaseResource
-          # The name of the field that was changed (e.g. `code`, `starts_at`, `ends_at`).
+        # Indicates a provider-specific issue that prevents the access code from being set or managed. Check the error message for details.
+        class ProviderIssue < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
           # @return [String]
-          attr_accessor :field
-          # The previous value of the field.
+          # Known values:
+          # - `provider_issue`
+          attr_accessor :error_code
+          # Indicates that this is an access code error.
+          # @return [TrueClass]
+          attr_accessor :is_access_code_error
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time, nil]
+          date_accessor :created_at
+        end
+
+        # Failed to set code on device.
+        class FailedToSetOnDevice < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `failed_to_set_on_device`
+          attr_accessor :error_code
+          # Indicates that this is an access code error.
+          # @return [TrueClass]
+          attr_accessor :is_access_code_error
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time, nil]
+          date_accessor :created_at
+        end
+
+        # Failed to remove code from device.
+        class FailedToRemoveFromDevice < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `failed_to_remove_from_device`
+          attr_accessor :error_code
+          # Indicates that this is an access code error.
+          # @return [TrueClass]
+          attr_accessor :is_access_code_error
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time, nil]
+          date_accessor :created_at
+        end
+
+        # Duplicate access code detected on device.
+        class DuplicateCodeOnDevice < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `duplicate_code_on_device`
+          attr_accessor :error_code
+          # Indicates that this is an access code error.
+          # @return [TrueClass]
+          attr_accessor :is_access_code_error
+          # ID of the managed access code that conflicts with this managed access code, when Seam can identify it.
           # @return [String, nil]
-          attr_accessor :from
-          # The new value of the field.
+          attr_accessor :managed_access_code_id
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # ID of the unmanaged access code that conflicts with this managed access code, when Seam can identify it.
           # @return [String, nil]
-          attr_accessor :to
+          attr_accessor :unmanaged_access_code_id
+          # Date and time at which Seam created the error.
+          # @return [Time, nil]
+          date_accessor :created_at
+        end
+
+        # No space for access code on device.
+        class NoSpaceForAccessCodeOnDevice < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `no_space_for_access_code_on_device`
+          attr_accessor :error_code
+          # Indicates that this is an access code error.
+          # @return [TrueClass]
+          attr_accessor :is_access_code_error
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time, nil]
+          date_accessor :created_at
+        end
+
+        # Code was modified or removed externally after Seam successfully set it on the device. The external change conflicts with the state that Seam is trying to apply, so Seam will attempt to set the code on the device again.
+        class ConflictingExternalModification < Errors
+          class ModifiedFields < BaseResource
+            # The name of the field that was changed (e.g. `code`, `starts_at`, `ends_at`).
+            # @return [String]
+            attr_accessor :field
+            # The previous value of the field.
+            # @return [String, nil]
+            attr_accessor :from
+            # The new value of the field.
+            # @return [String, nil]
+            attr_accessor :to
+          end
+
+          # List of fields that were changed externally, with their previous and new values.
+          # @return [Array<ModifiedFields>]
+          resource_list_accessor :modified_fields, ModifiedFields
+          # Indicates the type of external modification. `modified` means the code's PIN or schedule was changed. `removed` means the code was deleted from the device.
+          # @return [String, nil]
+          # Known values:
+          # - `modified`
+          # - `removed`
+          attr_accessor :change_type
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `conflicting_external_modification`
+          attr_accessor :error_code
+          # Indicates that this is an access code error.
+          # @return [TrueClass]
+          attr_accessor :is_access_code_error
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time, nil]
+          date_accessor :created_at
+        end
+
+        # Indicates that the access code is disabled or inactive on the device. The code exists but will not grant access until re-enabled.
+        class AccessCodeInactive < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `access_code_inactive`
+          attr_accessor :error_code
+          # Indicates that this is an access code error.
+          # @return [TrueClass]
+          attr_accessor :is_access_code_error
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time, nil]
+          date_accessor :created_at
+        end
+
+        # Indicates that the account is disconnected.
+        class AccountDisconnected < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `account_disconnected`
+          attr_accessor :error_code
+          # Indicates that the error is a [connected account](https://docs.seam.co/api/connected_accounts) error.
+          # @return [TrueClass]
+          attr_accessor :is_connected_account_error
+          # Indicates that the error is not a device error.
+          # @return [FalseClass]
+          attr_accessor :is_device_error
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that the Salto site user limit has been reached.
+        class SaltoKsSubscriptionLimitExceeded < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `salto_ks_subscription_limit_exceeded`
+          attr_accessor :error_code
+          # Indicates that the error is a [connected account](https://docs.seam.co/api/connected_accounts) error.
+          # @return [TrueClass]
+          attr_accessor :is_connected_account_error
+          # Indicates that the error is not a device error.
+          # @return [FalseClass]
+          attr_accessor :is_device_error
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that Seam's integration user does not have sufficient permissions on the provider's system to which this device belongs, so Seam cannot manage access codes or unlock the device. See the error message for specifics, then either reauthorize the connected account in Seam or grant the integration user the required permissions in the provider's system.
+        class InsufficientPermissions < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `insufficient_permissions`
+          attr_accessor :error_code
+          # Indicates that the error is a [connected account](https://docs.seam.co/api/connected_accounts) error.
+          # @return [TrueClass]
+          attr_accessor :is_connected_account_error
+          # Indicates that the error is not a device error.
+          # @return [FalseClass]
+          attr_accessor :is_device_error
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that one or more dormakaba sites associated with the connected account could not be connected. Contact dormakaba support.
+        class DormakabaSitesDisconnected < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `dormakaba_sites_disconnected`
+          attr_accessor :error_code
+          # Indicates that the error is a [connected account](https://docs.seam.co/api/connected_accounts) error.
+          # @return [TrueClass]
+          attr_accessor :is_connected_account_error
+          # Indicates that the error is not a device error.
+          # @return [FalseClass]
+          attr_accessor :is_device_error
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that the device is offline.
+        class DeviceOffline < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `device_offline`
+          attr_accessor :error_code
+          # Indicates that the error is a device error.
+          # @return [TrueClass]
+          attr_accessor :is_device_error
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that the device has been removed.
+        class DeviceRemoved < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `device_removed`
+          attr_accessor :error_code
+          # Indicates that the error is a device error.
+          # @return [TrueClass]
+          attr_accessor :is_device_error
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that the hub is disconnected.
+        class HubDisconnected < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `hub_disconnected`
+          attr_accessor :error_code
+          # Indicates that the error is a device error.
+          # @return [TrueClass]
+          attr_accessor :is_device_error
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that the device is disconnected.
+        class DeviceDisconnected < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `device_disconnected`
+          attr_accessor :error_code
+          # Indicates that the error is a device error.
+          # @return [TrueClass]
+          attr_accessor :is_device_error
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that the [backup access code pool](https://docs.seam.co/low-level-apis/smart-locks/access-codes/backup-access-codes) is empty.
+        class EmptyBackupAccessCodePool < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `empty_backup_access_code_pool`
+          attr_accessor :error_code
+          # Indicates that the error is a device error.
+          # @return [TrueClass]
+          attr_accessor :is_device_error
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that the user is not authorized to use the August lock.
+        class AugustLockNotAuthorized < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `august_lock_not_authorized`
+          attr_accessor :error_code
+          # Indicates that the error is a device error.
+          # @return [TrueClass]
+          attr_accessor :is_device_error
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that device credentials are missing.
+        class MissingDeviceCredentials < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `missing_device_credentials`
+          attr_accessor :error_code
+          # Indicates that the error is a device error.
+          # @return [TrueClass]
+          attr_accessor :is_device_error
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that the auxiliary heat is running.
+        class AuxiliaryHeatRunning < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `auxiliary_heat_running`
+          attr_accessor :error_code
+          # Indicates that the error is a device error.
+          # @return [TrueClass]
+          attr_accessor :is_device_error
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that a subscription is required to connect.
+        class SubscriptionRequired < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `subscription_required`
+          attr_accessor :error_code
+          # Indicates that the error is a device error.
+          # @return [TrueClass]
+          attr_accessor :is_device_error
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that the Seam API cannot communicate with [Seam Bridge](https://docs.seam.co/capability-guides/seam-bridge), for example, if the Seam Bridge executable has stopped or if the computer running the Seam Bridge executable is offline. See also [Troubleshooting Your Access Control System](https://docs.seam.co/low-level-apis/access-systems/troubleshooting-your-access-control-system#acs_system-errors-seam_bridge_disconnected).
+        class BridgeDisconnected < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `bridge_disconnected`
+          attr_accessor :error_code
+          # Indicates whether the error is related to [Seam Bridge](https://docs.seam.co/capability-guides/seam-bridge).
+          # @return [Boolean, nil]
+          attr_accessor :is_bridge_error
+          # Indicates whether the error is related specifically to the connected account.
+          # @return [Boolean, nil]
+          attr_accessor :is_connected_account_error
+          # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Date and time at which Seam created the error.
+          # @return [Time]
+          date_accessor :created_at
         end
 
-        # List of fields that were changed externally, with their previous and new values.
-        # @return [Array<ModifiedFields>]
-        resource_list_accessor :modified_fields, ModifiedFields
-        # Indicates the type of external modification. `modified` means the code's PIN or schedule was changed. `removed` means the code was deleted from the device.
-        # @return [String, nil]
-        attr_accessor :change_type
         # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
         # @return [String]
+        # Known values:
+        # - `provider_issue`
+        # - `failed_to_set_on_device`
+        # - `failed_to_remove_from_device`
+        # - `duplicate_code_on_device`
+        # - `no_space_for_access_code_on_device`
+        # - `conflicting_external_modification`
+        # - `access_code_inactive`
+        # - `account_disconnected`
+        # - `salto_ks_subscription_limit_exceeded`
+        # - `insufficient_permissions`
+        # - `dormakaba_sites_disconnected`
+        # - `device_offline`
+        # - `device_removed`
+        # - `hub_disconnected`
+        # - `device_disconnected`
+        # - `empty_backup_access_code_pool`
+        # - `august_lock_not_authorized`
+        # - `missing_device_credentials`
+        # - `auxiliary_heat_running`
+        # - `subscription_required`
+        # - `bridge_disconnected`
         attr_accessor :error_code
-        # Indicates that this is an access code error.
-        # @return [TrueClass]
-        attr_accessor :is_access_code_error
-        # Indicates whether the error is related to [Seam Bridge](https://docs.seam.co/capability-guides/seam-bridge).
-        # @return [Boolean, nil]
-        attr_accessor :is_bridge_error
-        # @return [Boolean, nil]
-        attr_accessor :is_connected_account_error
-        # @return [Boolean]
-        attr_accessor :is_device_error
-        # ID of the managed access code that conflicts with this managed access code, when Seam can identify it.
-        # @return [String, nil]
-        attr_accessor :managed_access_code_id
         # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
         # @return [String]
         attr_accessor :message
-        # ID of the unmanaged access code that conflicts with this managed access code, when Seam can identify it.
-        # @return [String, nil]
-        attr_accessor :unmanaged_access_code_id
         # Date and time at which Seam created the error.
         # @return [Time, nil]
         date_accessor :created_at
+
+        discriminated_by :error_code, {
+          "provider_issue" => ProviderIssue,
+          "failed_to_set_on_device" => FailedToSetOnDevice,
+          "failed_to_remove_from_device" => FailedToRemoveFromDevice,
+          "duplicate_code_on_device" => DuplicateCodeOnDevice,
+          "no_space_for_access_code_on_device" => NoSpaceForAccessCodeOnDevice,
+          "conflicting_external_modification" => ConflictingExternalModification,
+          "access_code_inactive" => AccessCodeInactive,
+          "account_disconnected" => AccountDisconnected,
+          "salto_ks_subscription_limit_exceeded" => SaltoKsSubscriptionLimitExceeded,
+          "insufficient_permissions" => InsufficientPermissions,
+          "dormakaba_sites_disconnected" => DormakabaSitesDisconnected,
+          "device_offline" => DeviceOffline,
+          "device_removed" => DeviceRemoved,
+          "hub_disconnected" => HubDisconnected,
+          "device_disconnected" => DeviceDisconnected,
+          "empty_backup_access_code_pool" => EmptyBackupAccessCodePool,
+          "august_lock_not_authorized" => AugustLockNotAuthorized,
+          "missing_device_credentials" => MissingDeviceCredentials,
+          "auxiliary_heat_running" => AuxiliaryHeatRunning,
+          "subscription_required" => SubscriptionRequired,
+          "bridge_disconnected" => BridgeDisconnected
+        }.freeze
       end
 
       class PendingMutations < BaseResource
@@ -124,6 +557,8 @@ module Seam
         # @return [String]
         attr_accessor :message
         # @return [String]
+        # Known values:
+        # - `creating`
         attr_accessor :mutation_code
         # Date and time at which the mutation was created.
         # @return [Time]
@@ -133,34 +568,229 @@ module Seam
         date_accessor :scheduled_at
       end
 
+      # Known `warning_code` values load as subclasses; unknown values remain Warnings instances for forward compatibility.
       class Warnings < BaseResource
-        class ModifiedFields < BaseResource
-          # The name of the field that was changed (e.g. `code`, `starts_at`, `ends_at`).
+        # The access code's PIN rotates periodically when the code is renewed. Retrieve the latest code before each use.
+        class CodeRotatesPeriodically < Warnings
+          # Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
           # @return [String]
-          attr_accessor :field
-          # The previous value of the field.
-          # @return [String, nil]
-          attr_accessor :from
-          # The new value of the field.
+          attr_accessor :message
+          # Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `code_rotates_periodically`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time, nil]
+          date_accessor :created_at
+        end
+
+        # The device's time zone is unknown and this code's time frame crosses a daylight-saving transition in at least one plausible time zone. A 1-hour safety buffer has been applied to the side of the time frame affected by the transition (`ends_at` for spring-forward, `starts_at` for fall-back) so the code stays active through the shift — the code may be usable up to 1 hour beyond your requested window. Set the device's time zone via `/devices/report_provider_metadata` to clear the buffer and guarantee exact handling.
+        class TimeFrameAdjustedForUnknownTimeZone < Warnings
+          # Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `time_frame_adjusted_for_unknown_time_zone`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time, nil]
+          date_accessor :created_at
+        end
+
+        # Code was modified or removed externally after Seam successfully set it on the device. External modification is allowed for this code, so the externally modified state is being honored.
+        class ExternalModificationInEffect < Warnings
+          class ModifiedFields < BaseResource
+            # The name of the field that was changed (e.g. `code`, `starts_at`, `ends_at`).
+            # @return [String]
+            attr_accessor :field
+            # The previous value of the field.
+            # @return [String, nil]
+            attr_accessor :from
+            # The new value of the field.
+            # @return [String, nil]
+            attr_accessor :to
+          end
+
+          # List of fields that were changed externally, with their previous and new values.
+          # @return [Array<ModifiedFields>]
+          resource_list_accessor :modified_fields, ModifiedFields
+          # Indicates the type of external modification. `modified` means the code's PIN or schedule was changed. `removed` means the code was deleted from the device.
           # @return [String, nil]
-          attr_accessor :to
+          # Known values:
+          # - `modified`
+          # - `removed`
+          attr_accessor :change_type
+          # Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `external_modification_in_effect`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time, nil]
+          date_accessor :created_at
+        end
+
+        # Delay in setting code on device.
+        class DelayInSettingOnDevice < Warnings
+          # Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `delay_in_setting_on_device`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time, nil]
+          date_accessor :created_at
+        end
+
+        # Delay in removing code from device.
+        class DelayInRemovingFromDevice < Warnings
+          # Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `delay_in_removing_from_device`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time, nil]
+          date_accessor :created_at
+        end
+
+        # Third-party integration detected that may cause access codes to fail.
+        class ThirdPartyIntegrationDetected < Warnings
+          # Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `third_party_integration_detected`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time, nil]
+          date_accessor :created_at
+        end
+
+        # Algopins must be used within 24 hours.
+        class IglooAlgopinMustBeUsedWithinN24Hours < Warnings
+          # Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `igloo_algopin_must_be_used_within_24_hours`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time, nil]
+          date_accessor :created_at
+        end
+
+        # Management was transferred to another workspace.
+        class ManagementTransferred < Warnings
+          # Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `management_transferred`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time, nil]
+          date_accessor :created_at
+        end
+
+        # A backup access code has been pulled and is being used in place of this access code.
+        class UsingBackupAccessCode < Warnings
+          # Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `using_backup_access_code`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time, nil]
+          date_accessor :created_at
+        end
+
+        # Access code is being deleted.
+        class BeingDeleted < Warnings
+          # Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `being_deleted`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time, nil]
+          date_accessor :created_at
+        end
+
+        # An unknown issue occurred with the access code.
+        class UnknownIssueWithAccessCode < Warnings
+          # Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `unknown_issue_with_access_code`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time, nil]
+          date_accessor :created_at
         end
 
-        # List of fields that were changed externally, with their previous and new values.
-        # @return [Array<ModifiedFields>]
-        resource_list_accessor :modified_fields, ModifiedFields
-        # Indicates the type of external modification. `modified` means the code's PIN or schedule was changed. `removed` means the code was deleted from the device.
-        # @return [String, nil]
-        attr_accessor :change_type
         # Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
         # @return [String]
         attr_accessor :message
         # Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
         # @return [String]
+        # Known values:
+        # - `code_rotates_periodically`
+        # - `time_frame_adjusted_for_unknown_time_zone`
+        # - `external_modification_in_effect`
+        # - `delay_in_setting_on_device`
+        # - `delay_in_removing_from_device`
+        # - `third_party_integration_detected`
+        # - `igloo_algopin_must_be_used_within_24_hours`
+        # - `management_transferred`
+        # - `using_backup_access_code`
+        # - `being_deleted`
+        # - `unknown_issue_with_access_code`
         attr_accessor :warning_code
         # Date and time at which Seam created the warning.
         # @return [Time, nil]
         date_accessor :created_at
+
+        discriminated_by :warning_code, {
+          "code_rotates_periodically" => CodeRotatesPeriodically,
+          "time_frame_adjusted_for_unknown_time_zone" => TimeFrameAdjustedForUnknownTimeZone,
+          "external_modification_in_effect" => ExternalModificationInEffect,
+          "delay_in_setting_on_device" => DelayInSettingOnDevice,
+          "delay_in_removing_from_device" => DelayInRemovingFromDevice,
+          "third_party_integration_detected" => ThirdPartyIntegrationDetected,
+          "igloo_algopin_must_be_used_within_24_hours" => IglooAlgopinMustBeUsedWithinN24Hours,
+          "management_transferred" => ManagementTransferred,
+          "using_backup_access_code" => UsingBackupAccessCode,
+          "being_deleted" => BeingDeleted,
+          "unknown_issue_with_access_code" => UnknownIssueWithAccessCode
+        }.freeze
       end
 
       # Metadata for a dormakaba Oracode managed access code. Only present for access codes from dormakaba Oracode devices.
@@ -219,9 +849,18 @@ module Seam
       attr_accessor :pulled_backup_access_code_id
       # Current status of the access code within the operational lifecycle. Values are `setting`, a transitional phase that indicates that the code is being configured or activated; `set`, which indicates that the code is active and operational; `unset`, which indicates a deactivated or unused state, either before activation or after deliberate deactivation; `removing`, which indicates a transitional period in which the code is being deleted or made inactive; and `unknown`, which indicates an indeterminate state, due to reasons such as system errors or incomplete data, that highlights a potential need for system review or troubleshooting. See also [Lifecycle of Access Codes](https://docs.seam.co/low-level-apis/smart-locks/access-codes/lifecycle-of-access-codes).
       # @return [String]
+      # Known values:
+      # - `setting`
+      # - `set`
+      # - `unset`
+      # - `removing`
+      # - `unknown`
       attr_accessor :status
       # Type of the access code. `ongoing` access codes are active continuously until deactivated manually. `time_bound` access codes have a specific duration.
       # @return [String]
+      # Known values:
+      # - `time_bound`
+      # - `ongoing`
       attr_accessor :type
       # Unique identifier for the Seam workspace associated with the access code.
       # @return [String]