seam 2.142.0 → 2.145.0

data/lib/seam/resources/acs_credential.rb

@@ -53,6 +53,9 @@ module Seam
         attr_accessor :auto_join
         # Card function type in the Visionline access system.
         # @return [String, nil]
+        # Known values:
+        # - `guest`
+        # - `staff`
         attr_accessor :card_function_type
         # ID of the card in the Visionline access system.
         # @return [String, nil]
@@ -74,22 +77,146 @@ module Seam
         attr_accessor :joiner_acs_credential_ids
       end
 
+      # Known `warning_code` values load as subclasses; unknown values remain Warnings instances for forward compatibility.
       class Warnings < BaseResource
+        # Indicates that the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) is waiting to be issued.
+        class WaitingToBeIssued < 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:
+          # - `waiting_to_be_issued`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that the schedule of one of the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials)'s children was modified externally.
+        class ScheduleExternallyModified < 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:
+          # - `schedule_externally_modified`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that the schedule of the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) was modified to avoid creating a credential with a start date in the past.
+        class ScheduleModified < 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:
+          # - `schedule_modified`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) 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]
+          date_accessor :created_at
+        end
+
+        # An unknown issue occurred while syncing the state of the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) with the provider. This issue may affect the proper functioning of the credential.
+        class UnknownIssueWithAcsCredential < 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_acs_credential`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Access permissions for the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) have changed. [Reissue](https://docs.seam.co/low-level-apis/access-systems/working-with-card-encoders-and-scanners/creating-and-encoding-card-based-credentials) (re-encode) the credential. This issue may affect the proper functioning of the credential.
+        class NeedsToBeReissued < 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:
+          # - `needs_to_be_reissued`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that the requested PIN code could not be used, so the access system assigned a different code. Give the guest the assigned code.
+        class RequestedCodeUnavailable < Warnings
+          # Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # The PIN code that was assigned instead.
+          # @return [String]
+          attr_accessor :new_code
+          # The originally requested PIN code that could not be used.
+          # @return [String]
+          attr_accessor :original_code
+          # Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `requested_code_unavailable`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
         # Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
         # @return [String]
         attr_accessor :message
-        # The PIN code that was assigned instead.
-        # @return [String]
-        attr_accessor :new_code
-        # The originally requested PIN code that could not be used.
-        # @return [String]
-        attr_accessor :original_code
         # Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
         # @return [String]
+        # Known values:
+        # - `waiting_to_be_issued`
+        # - `schedule_externally_modified`
+        # - `schedule_modified`
+        # - `being_deleted`
+        # - `unknown_issue_with_acs_credential`
+        # - `needs_to_be_reissued`
+        # - `requested_code_unavailable`
         attr_accessor :warning_code
         # Date and time at which Seam created the warning.
         # @return [Time]
         date_accessor :created_at
+
+        discriminated_by :warning_code, {
+          "waiting_to_be_issued" => WaitingToBeIssued,
+          "schedule_externally_modified" => ScheduleExternallyModified,
+          "schedule_modified" => ScheduleModified,
+          "being_deleted" => BeingDeleted,
+          "unknown_issue_with_acs_credential" => UnknownIssueWithAcsCredential,
+          "needs_to_be_reissued" => NeedsToBeReissued,
+          "requested_code_unavailable" => RequestedCodeUnavailable
+        }.freeze
       end
 
       # Akiles-specific metadata for the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials).
@@ -109,6 +236,11 @@ module Seam
       resource_list_accessor :warnings, Warnings
       # Access method for the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials). Supported values: `code`, `card`, `mobile_key`, `cloud_key`.
       # @return [String]
+      # Known values:
+      # - `code`
+      # - `card`
+      # - `mobile_key`
+      # - `cloud_key`
       attr_accessor :access_method
       # ID of the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials).
       # @return [String]
@@ -139,6 +271,21 @@ module Seam
       attr_accessor :ends_at
       # Brand-specific terminology for the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) type. Supported values: `pti_card`, `brivo_credential`, `hid_credential`, `visionline_card`.
       # @return [String, nil]
+      # Known values:
+      # - `pti_card`
+      # - `brivo_credential`
+      # - `hid_credential`
+      # - `visionline_card`
+      # - `salto_ks_credential`
+      # - `assa_abloy_vostio_key`
+      # - `salto_space_key`
+      # - `latch_access`
+      # - `dormakaba_ambiance_credential`
+      # - `hotek_card`
+      # - `salto_ks_tag`
+      # - `avigilon_alta_credential`
+      # - `kisi_credential`
+      # - `akiles_credential`
       attr_accessor :external_type
       # Display name that corresponds to the brand-specific terminology for the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) type.
       # @return [String, nil]

data/lib/seam/resources/acs_encoder.rb

@@ -20,6 +20,8 @@ module Seam
       class Errors < BaseResource
         # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
         # @return [String]
+        # Known values:
+        # - `acs_encoder_removed`
         attr_accessor :error_code
         # Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
         # @return [String]

data/lib/seam/resources/acs_entrance.rb

@@ -39,6 +39,11 @@ module Seam
         attr_accessor :door_number
         # Type of the door in the Vostio access system.
         # @return [String, nil]
+        # Known values:
+        # - `CommonDoor`
+        # - `EntranceDoor`
+        # - `GuestDoor`
+        # - `Elevator`
         attr_accessor :door_type
         # PMS ID of the door in the Vostio access system.
         # @return [String, nil]
@@ -190,6 +195,10 @@ module Seam
           attr_accessor :visionline_door_profile_id
           # Door profile type in the Visionline access system.
           # @return [String, nil]
+          # Known values:
+          # - `BLE`
+          # - `commonDoor`
+          # - `touch`
           attr_accessor :visionline_door_profile_type
         end
 
@@ -198,22 +207,118 @@ module Seam
         resource_list_accessor :profiles, Profiles
         # Category of the door in the Visionline access system.
         # @return [String, nil]
+        # Known values:
+        # - `entrance`
+        # - `guest`
+        # - `elevator reader`
+        # - `common`
+        # - `common (PMS)`
         attr_accessor :door_category
         # Name of the door in the Visionline access system.
         # @return [String, nil]
         attr_accessor :door_name
       end
 
+      # Known `warning_code` values load as subclasses; unknown values remain Warnings instances for forward compatibility.
       class Warnings < BaseResource
+        # Indicates that a change in the reported device model has been detected for this Salto KS entrance, which may occur after an IQ hub reset. Access code support may be affected. See https://help.getseam.com/articles/5098842588-salto-ks-lock-loses-access-code-support for troubleshooting steps.
+        class SaltoKsEntranceAccessCodeSupportRemoved < 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:
+          # - `salto_ks_entrance_access_code_support_removed`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that this entrance shares a zone with other entrances in Avigilon Alta and cannot be added to an access group individually.
+        class EntranceSharesZone < 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:
+          # - `entrance_shares_zone`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that this entrance requires additional configuration in the access control system before Seam can fully manage it.
+        class EntranceSetupRequired < 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:
+          # - `entrance_setup_required`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that this entrance is in privacy mode. When privacy mode is enabled, access codes, mobile keys, and remote unlocks will not work unless the user has admin access.
+        class SaltoKsPrivacyMode < 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:
+          # - `salto_ks_privacy_mode`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that this entrance is in privacy mode. When privacy mode is enabled, access codes, mobile keys, and remote unlocks will not work unless the user has admin access.
+        class PrivacyMode < 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:
+          # - `privacy_mode`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
         # 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:
+        # - `salto_ks_entrance_access_code_support_removed`
+        # - `entrance_shares_zone`
+        # - `entrance_setup_required`
+        # - `salto_ks_privacy_mode`
+        # - `privacy_mode`
         attr_accessor :warning_code
         # Date and time at which Seam created the warning.
         # @return [Time]
         date_accessor :created_at
+
+        discriminated_by :warning_code, {
+          "salto_ks_entrance_access_code_support_removed" => SaltoKsEntranceAccessCodeSupportRemoved,
+          "entrance_shares_zone" => EntranceSharesZone,
+          "entrance_setup_required" => EntranceSetupRequired,
+          "salto_ks_privacy_mode" => SaltoKsPrivacyMode,
+          "privacy_mode" => PrivacyMode
+        }.freeze
       end
 
       # Akiles-specific metadata associated with the [entrance](https://docs.seam.co/low-level-apis/access-systems/retrieving-entrance-details).

data/lib/seam/resources/acs_system.rb

@@ -8,19 +8,182 @@ module Seam
     #
     # For details about the resources associated with an access control system, see the [access control systems namespace](https://docs.seam.co/api/acs).
     class AcsSystem < BaseResource
+      # Known `error_code` values load as subclasses; unknown values remain Errors instances for forward compatibility.
       class Errors < BaseResource
+        # Indicates that the Seam API cannot communicate with [Seam Bridge](https://docs.seam.co/capability-guides/seam-bridge), for example, if Seam Bridge executable has stopped or if the computer running the Seam Bridge executable is offline.
+        # This error might also occur if Seam Bridge is connected to the wrong [workspace](https://docs.seam.co/core-concepts/workspaces).
+        # 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 SeamBridgeDisconnected < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `seam_bridge_disconnected`
+          attr_accessor :error_code
+          # 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 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 the [Seam Bridge](https://docs.seam.co/capability-guides/seam-bridge).
+          # @return [Boolean, nil]
+          attr_accessor :is_bridge_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 Bridge](https://docs.seam.co/capability-guides/seam-bridge) is functioning correctly and the Seam API can communicate with Seam Bridge, but the Seam API cannot connect to the on-premises [Visionline access control system](https://docs.seam.co/device-and-system-integration-guides/assa-abloy-visionline-access-control-system).
+        # For example, the IP address of the on-premises access control system may be set incorrectly within the Seam [workspace](https://docs.seam.co/core-concepts/workspaces).
+        # See also [Troubleshooting Your Access Control System](https://docs.seam.co/low-level-apis/access-systems/troubleshooting-your-access-control-system#acs_system-errors-visionline_instance_unreachable).
+        class VisionlineInstanceUnreachable < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `visionline_instance_unreachable`
+          attr_accessor :error_code
+          # 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 maximum number of users allowed for the site has been reached. This means that new access codes cannot be created. Contact Salto support to increase the user limit.
+        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
+          # 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 backing this [access control system](https://docs.seam.co/low-level-apis/access-systems). Access cannot be managed until permissions are restored. 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
+          # 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 [access control system](https://docs.seam.co/low-level-apis/access-systems) has been disconnected. See [Troubleshooting Your Access Control System](https://docs.seam.co/low-level-apis/access-systems/troubleshooting-your-access-control-system) to resolve the issue.
+        class AcsSystemDisconnected < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `acs_system_disconnected`
+          attr_accessor :error_code
+          # 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 login credentials are invalid. Reconnect the account using a [Connect Webview](https://docs.seam.co/core-concepts/connect-webviews) to restore access.
+        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
+          # 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 [access control system](https://docs.seam.co/low-level-apis/access-systems) has lost its Salto KS certification. Contact [support](mailto:support@seam.co) to regain access.
+        class SaltoKsCertificationExpired < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `salto_ks_certification_expired`
+          attr_accessor :error_code
+          # 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 access control system provider's service is temporarily unavailable. Seam will automatically retry and reconnect when the service becomes available again.
+        class ProviderServiceUnavailable < Errors
+          # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `provider_service_unavailable`
+          attr_accessor :error_code
+          # 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
+
         # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
         # @return [String]
+        # Known values:
+        # - `seam_bridge_disconnected`
+        # - `bridge_disconnected`
+        # - `visionline_instance_unreachable`
+        # - `salto_ks_subscription_limit_exceeded`
+        # - `insufficient_permissions`
+        # - `acs_system_disconnected`
+        # - `account_disconnected`
+        # - `salto_ks_certification_expired`
+        # - `provider_service_unavailable`
         attr_accessor :error_code
-        # Indicates whether the error is related to the [Seam Bridge](https://docs.seam.co/capability-guides/seam-bridge).
-        # @return [Boolean, nil]
-        attr_accessor :is_bridge_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
+
+        discriminated_by :error_code, {
+          "seam_bridge_disconnected" => SeamBridgeDisconnected,
+          "bridge_disconnected" => BridgeDisconnected,
+          "visionline_instance_unreachable" => VisionlineInstanceUnreachable,
+          "salto_ks_subscription_limit_exceeded" => SaltoKsSubscriptionLimitExceeded,
+          "insufficient_permissions" => InsufficientPermissions,
+          "acs_system_disconnected" => AcsSystemDisconnected,
+          "account_disconnected" => AccountDisconnected,
+          "salto_ks_certification_expired" => SaltoKsCertificationExpired,
+          "provider_service_unavailable" => ProviderServiceUnavailable
+        }.freeze
       end
 
       class Location < BaseResource
@@ -41,19 +204,92 @@ module Seam
         attr_accessor :system_id
       end
 
+      # Known `warning_code` values load as subclasses; unknown values remain Warnings instances for forward compatibility.
       class Warnings < BaseResource
+        # Indicates that the Salto KS site has exceeded 80% of the maximum number of allowed users. Increase your subscription limit or delete some users from your site to rectify the issue.
+        class SaltoKsSubscriptionLimitAlmostReached < 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:
+          # - `salto_ks_subscription_limit_almost_reached`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates the [access control system](https://docs.seam.co/low-level-apis/access-systems) time zone could not be determined because the reported physical location does not match the time zone configured on the physical [ACS entrances](https://docs.seam.co/low-level-apis/access-systems/retrieving-entrance-details).
+        class TimeZoneDoesNotMatchLocation < Warnings
+          # Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
+          # @return [String]
+          attr_accessor :message
+          # @return [Array<String>]
+          # @deprecated this field is deprecated.
+          attr_accessor :misconfigured_acs_entrance_ids
+          # Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
+          # @return [String]
+          # Known values:
+          # - `time_zone_does_not_match_location`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that the access control system requires additional setup before it can be fully operational. Follow the instructions in the warning message to complete the setup.
+        class SetupRequired < 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:
+          # - `setup_required`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
+        # Indicates that Seam encountered an unexpected error while syncing this [access control system](https://docs.seam.co/low-level-apis/access-systems), so its users, credentials, and access groups may be out of date. Seam retries on every sync cycle and clears this warning once a sync succeeds; if it persists, contact [support](mailto:support@seam.co).
+        class UnknownIssueWithAcsSystem < 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_acs_system`
+          attr_accessor :warning_code
+          # Date and time at which Seam created the warning.
+          # @return [Time]
+          date_accessor :created_at
+        end
+
         # Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
         # @return [String]
         attr_accessor :message
-        # @return [Array<String>]
-        # @deprecated this field is deprecated.
-        attr_accessor :misconfigured_acs_entrance_ids
         # Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
         # @return [String]
+        # Known values:
+        # - `salto_ks_subscription_limit_almost_reached`
+        # - `time_zone_does_not_match_location`
+        # - `setup_required`
+        # - `unknown_issue_with_acs_system`
         attr_accessor :warning_code
         # Date and time at which Seam created the warning.
         # @return [Time]
         date_accessor :created_at
+
+        discriminated_by :warning_code, {
+          "salto_ks_subscription_limit_almost_reached" => SaltoKsSubscriptionLimitAlmostReached,
+          "time_zone_does_not_match_location" => TimeZoneDoesNotMatchLocation,
+          "setup_required" => SetupRequired,
+          "unknown_issue_with_acs_system" => UnknownIssueWithAcsSystem
+        }.freeze
       end
 
       # Location information for the [access control system](https://docs.seam.co/low-level-apis/access-systems).
@@ -89,6 +325,24 @@ module Seam
       attr_accessor :default_credential_manager_acs_system_id
       # Brand-specific terminology for the [access control system](https://docs.seam.co/low-level-apis/access-systems) type.
       # @return [String, nil]
+      # Known values:
+      # - `pti_site`
+      # - `avigilon_alta_org`
+      # - `salto_ks_site`
+      # - `salto_space_system`
+      # - `brivo_account`
+      # - `hid_credential_manager_organization`
+      # - `visionline_system`
+      # - `assa_abloy_credential_service`
+      # - `latch_building`
+      # - `dormakaba_community_site`
+      # - `dormakaba_ambiance_site`
+      # - `legic_connect_credential_service`
+      # - `assa_abloy_vostio`
+      # - `assa_abloy_vostio_credential_service`
+      # - `hotek_site`
+      # - `kisi_organization`
+      # - `akiles_organization`
       attr_accessor :external_type
       # Display name that corresponds to the brand-specific terminology for the [access control system](https://docs.seam.co/low-level-apis/access-systems) type.
       # @return [String, nil]
@@ -106,6 +360,24 @@ module Seam
       # @return [String]
       attr_accessor :name
       # @return [String, nil]
+      # Known values:
+      # - `pti_site`
+      # - `avigilon_alta_org`
+      # - `salto_ks_site`
+      # - `salto_space_system`
+      # - `brivo_account`
+      # - `hid_credential_manager_organization`
+      # - `visionline_system`
+      # - `assa_abloy_credential_service`
+      # - `latch_building`
+      # - `dormakaba_community_site`
+      # - `dormakaba_ambiance_site`
+      # - `legic_connect_credential_service`
+      # - `assa_abloy_vostio`
+      # - `assa_abloy_vostio_credential_service`
+      # - `hotek_site`
+      # - `kisi_organization`
+      # - `akiles_organization`
       # @deprecated Use `external_type`.
       attr_accessor :system_type
       # @return [String, nil]