seam 2.138.0 → 2.140.0

data/lib/seam/resources/access_grant.rb

@@ -6,128 +6,188 @@ module Seam
     class AccessGrant < BaseResource
       class Errors < BaseResource
         # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+        # @return [String]
         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
         # IDs of the devices that did not receive an access code at grant creation. Use these to identify which specific devices failed when the message reports a partial failure.
+        # @return [Array<String>]
         attr_accessor :missing_device_ids
         # Date and time at which Seam created the error.
+        # @return [Time]
         date_accessor :created_at
       end
 
       class PendingMutations < BaseResource
         class From < BaseResource
           # Previous device IDs where access codes existed.
+          # @return [Array<String>]
           attr_accessor :device_ids
           # Previous end time for access.
+          # @return [Time, nil]
           date_accessor :ends_at
           # Previous start time for access.
+          # @return [Time, nil]
           date_accessor :starts_at
         end
 
         class To < BaseResource
           # Common code key to ensure PIN code reuse across devices.
+          # @return [String, nil]
           attr_accessor :common_code_key
           # New device IDs where access codes should be created.
+          # @return [Array<String>]
           attr_accessor :device_ids
           # New end time for access.
+          # @return [Time, nil]
           date_accessor :ends_at
           # New start time for access.
+          # @return [Time, nil]
           date_accessor :starts_at
         end
 
+        # @return [From]
         resource_accessor :from, From
+        # @return [To]
         resource_accessor :to, To
         # IDs of the access methods being updated.
+        # @return [Array<String>]
         attr_accessor :access_method_ids
         # Detailed description of the mutation.
+        # @return [String]
         attr_accessor :message
+        # @return [String]
         attr_accessor :mutation_code
         # Date and time at which the mutation was created.
+        # @return [Time]
         date_accessor :created_at
       end
 
       class RequestedAccessMethods < BaseResource
         # Specific PIN code to use for this access method. Only applicable when mode is 'code'.
+        # @return [String, nil]
         attr_accessor :code
         # IDs of the access methods created for the requested access method.
+        # @return [Array<String>]
         attr_accessor :created_access_method_ids
         # Display name of the access method.
+        # @return [String]
         attr_accessor :display_name
         # Maximum number of times the instant key can be used. Only applicable when mode is 'mobile_key'. Defaults to 1 if not specified.
+        # @return [Integer, nil]
         attr_accessor :instant_key_max_use_count
         # Access method mode. Supported values: `code`, `card`, `mobile_key`, `cloud_key`.
+        # @return [String]
         attr_accessor :mode
         # Date and time at which the requested access method was added to the Access Grant.
+        # @return [Time]
         date_accessor :created_at
       end
 
       class Warnings < BaseResource
         class FailedDevices < BaseResource
           # Device whose access code could not be revoked.
+          # @return [String]
           attr_accessor :device_id
           # Reason the access code could not be revoked (e.g. `offline_access_code_not_revocable`).
+          # @return [String]
           attr_accessor :error_code
           # Human-readable description of why revocation failed.
+          # @return [String]
           attr_accessor :message
         end
 
+        # Devices whose access codes could not be revoked during reconciliation. Present when the provider does not support revoking an offline access code (e.g. Dormakaba oracode with exhausted override budget).
+        # @return [Array<FailedDevices>]
         resource_list_accessor :failed_devices, FailedDevices
         # IDs of the access methods being updated.
+        # @return [Array<String>]
         attr_accessor :access_method_ids
+        # @return [String]
         attr_accessor :device_id
         # Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
+        # @return [String]
         attr_accessor :message
         # The new PIN code that was assigned instead.
+        # @return [String]
         attr_accessor :new_code
         # The originally requested PIN code that was unavailable.
+        # @return [String]
         attr_accessor :original_code
         # Specific reason why the grant's times are not programmable on the device.
+        # @return [String]
         attr_accessor :reason
         # Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
+        # @return [String]
         attr_accessor :warning_code
         # Date and time at which Seam created the warning.
+        # @return [Time]
         date_accessor :created_at
       end
 
+      # Errors associated with the [access grant](https://docs.seam.co/use-cases/granting-access).
+      # @return [Array<Errors>]
       resource_list_accessor :errors, Errors
+      # List of pending mutations for the access grant. This shows updates that are in progress.
+      # @return [Array<PendingMutations>]
       resource_list_accessor :pending_mutations, PendingMutations
+      # Access methods that the user requested for the Access Grant.
+      # @return [Array<RequestedAccessMethods>]
       resource_list_accessor :requested_access_methods, RequestedAccessMethods
+      # Warnings associated with the [access grant](https://docs.seam.co/use-cases/granting-access).
+      # @return [Array<Warnings>]
       resource_list_accessor :warnings, Warnings
       # ID of the Access Grant.
+      # @return [String]
       attr_accessor :access_grant_id
       # Unique key for the access grant within the workspace.
+      # @return [String, nil]
       attr_accessor :access_grant_key
       # IDs of the access methods created for the Access Grant.
+      # @return [Array<String>]
       attr_accessor :access_method_ids
       # Client Session Token. Only returned if the Access Grant has a mobile_key access method.
+      # @return [String, nil]
       attr_accessor :client_session_token
       # ID of the customization profile associated with the Access Grant.
+      # @return [String, nil]
       attr_accessor :customization_profile_id
       # Display name of the Access Grant.
+      # @return [String]
       attr_accessor :display_name
       # Instant Key URL. Only returned if the Access Grant has a single mobile_key access_method.
+      # @return [String, nil]
       attr_accessor :instant_key_url
+      # @return [Array<String>]
       # @deprecated Use `space_ids`.
       attr_accessor :location_ids
       # Name of the Access Grant. If not provided, the display name will be computed.
+      # @return [String, nil]
       attr_accessor :name
       # Reservation key for the access grant.
+      # @return [String, nil]
       attr_accessor :reservation_key
       # IDs of the spaces to which the Access Grant gives access.
+      # @return [Array<String>]
       attr_accessor :space_ids
       # ID of user identity to which the Access Grant gives access.
+      # @return [String]
       attr_accessor :user_identity_id
       # ID of the Seam workspace associated with the Access Grant.
+      # @return [String]
       attr_accessor :workspace_id
 
       # Date and time at which the Access Grant was created.
+      # @return [Time]
       date_accessor :created_at
 
       # Date and time at which the Access Grant ends.
+      # @return [Time, nil]
       date_accessor :ends_at
 
       # Date and time at which the Access Grant starts.
+      # @return [Time]
       date_accessor :starts_at
     end
   end

data/lib/seam/resources/access_method.rb

@@ -6,84 +6,123 @@ module Seam
     class AccessMethod < BaseResource
       class Errors < BaseResource
         # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+        # @return [String]
         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
 
       class PendingMutations < BaseResource
         class From < BaseResource
+          # @return [Array<String>]
           attr_accessor :device_ids
           # Previous end time for access.
+          # @return [Time, nil]
           date_accessor :ends_at
           # Previous start time for access.
+          # @return [Time, nil]
           date_accessor :starts_at
         end
 
         class To < BaseResource
+          # @return [Array<String>]
           attr_accessor :device_ids
           # New end time for access.
+          # @return [Time, nil]
           date_accessor :ends_at
           # New start time for access.
+          # @return [Time, nil]
           date_accessor :starts_at
         end
 
+        # @return [From]
         resource_accessor :from, From
+        # @return [To]
         resource_accessor :to, To
         # Detailed description of the mutation.
+        # @return [String]
         attr_accessor :message
+        # @return [String]
         attr_accessor :mutation_code
         # Date and time at which the mutation was created.
+        # @return [Time]
         date_accessor :created_at
       end
 
       class Warnings < BaseResource
         # Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
+        # @return [String]
         attr_accessor :message
         # ID of the original access method from which this backup access method was split, if applicable.
+        # @return [String, nil]
         attr_accessor :original_access_method_id
         # Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
+        # @return [String]
         attr_accessor :warning_code
         # Date and time at which Seam created the warning.
+        # @return [Time]
         date_accessor :created_at
       end
 
+      # Errors associated with the [access method](https://docs.seam.co/use-cases/granting-access/creating-an-access-grant).
+      # @return [Array<Errors>]
       resource_list_accessor :errors, Errors
+      # Pending mutations for the [access method](https://docs.seam.co/use-cases/granting-access/creating-an-access-grant). Indicates operations that are in progress.
+      # @return [Array<PendingMutations>]
       resource_list_accessor :pending_mutations, PendingMutations
+      # Warnings associated with the [access method](https://docs.seam.co/use-cases/granting-access/creating-an-access-grant).
+      # @return [Array<Warnings>]
       resource_list_accessor :warnings, Warnings
       # ID of the access method.
+      # @return [String]
       attr_accessor :access_method_id
       # Token of the client session associated with the access method.
+      # @return [String, nil]
       attr_accessor :client_session_token
       # The actual PIN code for code access methods.
+      # @return [String, nil]
       attr_accessor :code
       # ID of the customization profile associated with the access method.
+      # @return [String, nil]
       attr_accessor :customization_profile_id
       # Display name of the access method.
+      # @return [String]
       attr_accessor :display_name
       # URL of the Instant Key for mobile key access methods.
+      # @return [String, nil]
       attr_accessor :instant_key_url
       # Indicates whether an existing card credential must be assigned to this access method before it can be issued. Only applies to card-mode access methods on systems that support credential assignment.
+      # @return [Boolean, nil]
       attr_accessor :is_assignment_required
       # Indicates whether encoding with an card encoder is required to issue or reissue the plastic card associated with the access method.
+      # @return [Boolean, nil]
       attr_accessor :is_encoding_required
       # Indicates whether the access method has been issued.
+      # @return [Boolean]
       attr_accessor :is_issued
       # Indicates whether the access method is ready for card assignment. This is true when the access method is in card mode, has not yet been issued, and the system supports credential assignment.
+      # @return [Boolean, nil]
       attr_accessor :is_ready_for_assignment
       # Indicates whether the access method is ready to be encoded. This is true when the credential has been created and the card has not yet been issued.
+      # @return [Boolean, nil]
       attr_accessor :is_ready_for_encoding
       # Access method mode. Supported values: `code`, `card`, `mobile_key`, `cloud_key`.
+      # @return [String]
       attr_accessor :mode
       # ID of the Seam workspace associated with the access method.
+      # @return [String]
       attr_accessor :workspace_id
 
       # Date and time at which the access method was created.
+      # @return [Time]
       date_accessor :created_at
 
       # Date and time at which the access method was issued.
+      # @return [Time, nil]
       date_accessor :issued_at
     end
   end

data/lib/seam/resources/acs_access_group.rb

@@ -10,97 +10,142 @@ module Seam
     class AcsAccessGroup < BaseResource
       class AccessSchedule < BaseResource
         # Date and time at which the user's access ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
+        # @return [Time, nil]
         date_accessor :ends_at
         # Date and time at which the user's access starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
+        # @return [Time]
         date_accessor :starts_at
       end
 
       class Errors < BaseResource
         # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+        # @return [String]
         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
 
       class PendingMutations < BaseResource
         class From < BaseResource
           # Old entrance ID.
+          # @return [String, nil]
           attr_accessor :acs_entrance_id
           # Old user ID.
+          # @return [String, nil]
           attr_accessor :acs_user_id
           # Name of the access group.
+          # @return [String, nil]
           attr_accessor :name
           # Ending time for the access schedule.
+          # @return [Time, nil]
           date_accessor :ends_at
           # Starting time for the access schedule.
+          # @return [Time, nil]
           date_accessor :starts_at
         end
 
         class To < BaseResource
           # New entrance ID.
+          # @return [String, nil]
           attr_accessor :acs_entrance_id
           # New user ID.
+          # @return [String, nil]
           attr_accessor :acs_user_id
           # Name of the access group.
+          # @return [String, nil]
           attr_accessor :name
           # Ending time for the access schedule.
+          # @return [Time, nil]
           date_accessor :ends_at
           # Starting time for the access schedule.
+          # @return [Time, nil]
           date_accessor :starts_at
         end
 
+        # @return [From]
         resource_accessor :from, From
+        # @return [To]
         resource_accessor :to, To
         # ID of the user involved in the scheduled change.
+        # @return [String]
         attr_accessor :acs_user_id
         # Detailed description of the mutation.
+        # @return [String]
         attr_accessor :message
+        # @return [String]
         attr_accessor :mutation_code
         # Whether the user is scheduled to be added to or removed from this access group.
+        # @return [String]
         attr_accessor :variant
         # Date and time at which the mutation was created.
+        # @return [Time]
         date_accessor :created_at
       end
 
       class Warnings < BaseResource
         # 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]
         attr_accessor :warning_code
         # Date and time at which Seam created the warning.
+        # @return [Time]
         date_accessor :created_at
       end
 
+      # `starts_at` and `ends_at` timestamps for the access group's access.
+      # @return [AccessSchedule, nil]
       resource_accessor :access_schedule, AccessSchedule
+      # Errors associated with the `acs_access_group`.
+      # @return [Array<Errors>]
       resource_list_accessor :errors, Errors
+      # Collection of pending mutations for the access group. Represents operations that have been requested but not yet completed on the integrated access system.
+      # @return [Array<PendingMutations>]
       resource_list_accessor :pending_mutations, PendingMutations
+      # Warnings associated with the `acs_access_group`.
+      # @return [Array<Warnings>]
       resource_list_accessor :warnings, Warnings
+      # @return [String]
       # @deprecated Use `external_type`.
       attr_accessor :access_group_type
+      # @return [String]
       # @deprecated Use `external_type_display_name`.
       attr_accessor :access_group_type_display_name
       # ID of the access group.
+      # @return [String]
       attr_accessor :acs_access_group_id
       # ID of the access control system that contains the access group.
+      # @return [String]
       attr_accessor :acs_system_id
       # ID of the connected account that contains the access group.
+      # @return [String]
       attr_accessor :connected_account_id
       # Display name for the access group.
+      # @return [String]
       attr_accessor :display_name
       # Brand-specific terminology for the access group type.
+      # @return [String]
       attr_accessor :external_type
       # Display name that corresponds to the brand-specific terminology for the access group type.
+      # @return [String]
       attr_accessor :external_type_display_name
       # Indicates whether Seam manages the access group.
+      # @return [Boolean]
       attr_accessor :is_managed
       # Name of the access group.
+      # @return [String]
       attr_accessor :name
       # ID of the workspace that contains the access group.
+      # @return [String]
       attr_accessor :workspace_id
 
       # Date and time at which the access group was created.
+      # @return [Time]
       date_accessor :created_at
     end
   end

data/lib/seam/resources/acs_credential.rb

@@ -10,110 +10,177 @@ module Seam
     #
     # For granting a person access to a space, [Access Grants](https://docs.seam.co/use-cases/granting-access) are the default and recommended approach. Use the lower-level ACS credential API directly only when you specifically need to manage individual credentials.
     class AcsCredential < BaseResource
+      class AkilesMetadata < BaseResource
+        # ID of the Akiles member PIN.
+        # @return [String, nil]
+        attr_accessor :member_pin_id
+      end
+
       class AssaAbloyVostioMetadata < BaseResource
         # Indicates whether the credential should auto-join. For an auto-join credential, Seam automatically issues an override card if there are no other cards and a joiner card if there are existing cards on the doors.
+        # @return [Boolean, nil]
         attr_accessor :auto_join
         # Names of the doors to which to grant access in the Vostio access system.
+        # @return [Array<String>]
         attr_accessor :door_names
         # Endpoint ID in the Vostio access system.
+        # @return [String, nil]
         attr_accessor :endpoint_id
         # Key ID in the Vostio access system.
+        # @return [String, nil]
         attr_accessor :key_id
         # Key issuing request ID in the Vostio access system.
+        # @return [String, nil]
         attr_accessor :key_issuing_request_id
         # IDs of the guest entrances to override in the Vostio access system.
+        # @return [Array<String>]
         attr_accessor :override_guest_acs_entrance_ids
       end
 
       class Errors < BaseResource
+        # @return [String]
         attr_accessor :error_code
+        # @return [String]
         attr_accessor :message
         # Date and time at which Seam created the error.
+        # @return [Time]
         date_accessor :created_at
       end
 
       class VisionlineMetadata < BaseResource
         # Indicates whether the credential should auto-join. For an auto-join credential, Seam automatically issues an override card if there are no other cards and a joiner card if there are existing cards on the doors.
+        # @return [Boolean, nil]
         attr_accessor :auto_join
         # Card function type in the Visionline access system.
+        # @return [String, nil]
         attr_accessor :card_function_type
         # ID of the card in the Visionline access system.
+        # @return [String, nil]
         attr_accessor :card_id
         # Common entrance IDs in the Visionline access system.
+        # @return [Array<String>]
         attr_accessor :common_acs_entrance_ids
         # ID of the credential in the Visionline access system.
+        # @return [String, nil]
         attr_accessor :credential_id
         # Guest entrance IDs in the Visionline access system.
+        # @return [Array<String>]
         attr_accessor :guest_acs_entrance_ids
         # Indicates whether the credential is valid.
+        # @return [Boolean, nil]
         attr_accessor :is_valid
         # IDs of the credentials to which you want to join.
+        # @return [Array<String>]
         attr_accessor :joiner_acs_credential_ids
       end
 
       class Warnings < BaseResource
         # 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]
         attr_accessor :warning_code
         # Date and time at which Seam created the warning.
+        # @return [Time]
         date_accessor :created_at
       end
 
+      # Akiles-specific metadata for the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials).
+      # @return [AkilesMetadata, nil]
+      resource_accessor :akiles_metadata, AkilesMetadata
+      # Vostio-specific metadata for the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials).
+      # @return [AssaAbloyVostioMetadata, nil]
       resource_accessor :assa_abloy_vostio_metadata, AssaAbloyVostioMetadata
+      # Visionline-specific metadata for the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials).
+      # @return [VisionlineMetadata, nil]
       resource_accessor :visionline_metadata, VisionlineMetadata
+      # Errors associated with the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials).
+      # @return [Array<Errors>]
       resource_list_accessor :errors, Errors
+      # Warnings associated with the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials).
+      # @return [Array<Warnings>]
       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]
       attr_accessor :access_method
       # ID of the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials).
+      # @return [String]
       attr_accessor :acs_credential_id
       # ID of the credential pool to which the credential belongs.
+      # @return [String, nil]
       attr_accessor :acs_credential_pool_id
       # ID of the [access control system](https://docs.seam.co/low-level-apis/access-systems) that contains the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials).
+      # @return [String]
       attr_accessor :acs_system_id
       # ID of the [ACS user](https://docs.seam.co/low-level-apis/access-systems/user-management) to whom the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) belongs.
+      # @return [String, nil]
       attr_accessor :acs_user_id
       # Number of the card associated with the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials).
+      # @return [String, nil]
       attr_accessor :card_number
       # Access (PIN) code for the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials).
+      # @return [String, nil]
       attr_accessor :code
       # ID of the [connected account](https://docs.seam.co/core-concepts/connected-accounts) to which the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) belongs.
+      # @return [String]
       attr_accessor :connected_account_id
       # Display name that corresponds to the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) type.
+      # @return [String]
       attr_accessor :display_name
       # Date and time at which the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) validity ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. Must be a time in the future and after `starts_at`.
+      # @return [String, nil]
       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]
       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]
       attr_accessor :external_type_display_name
       # Indicates whether the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) has been encoded onto a card.
+      # @return [Boolean, nil]
       attr_accessor :is_issued
       # Indicates whether the latest state of the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) has been synced from Seam to the provider.
+      # @return [Boolean, nil]
       attr_accessor :is_latest_desired_state_synced_with_provider
       # Indicates whether Seam manages the credential.
+      # @return [Boolean]
       attr_accessor :is_managed
       # Indicates whether the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) is a [multi-phone sync credential](https://docs.seam.co/capability-guides/mobile-access/issuing-mobile-credentials-from-an-access-control-system#what-are-multi-phone-sync-credentials).
+      # @return [Boolean, nil]
       attr_accessor :is_multi_phone_sync_credential
       # Indicates whether the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) can only be used once. If `true`, the code becomes invalid after the first use.
+      # @return [Boolean, nil]
       attr_accessor :is_one_time_use
       # ID of the parent [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials).
+      # @return [String, nil]
       attr_accessor :parent_acs_credential_id
       # Date and time at which the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) validity starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
+      # @return [String, nil]
       attr_accessor :starts_at
       # ID of the [user identity](https://docs.seam.co/api/user_identities) to whom the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) belongs.
+      # @return [String, nil]
       attr_accessor :user_identity_id
       # ID of the workspace that contains the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials).
+      # @return [String]
       attr_accessor :workspace_id
 
       # Date and time at which the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) was created.
+      # @return [Time]
       date_accessor :created_at
 
       # Date and time at which the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) was encoded onto a card.
+      # @return [Time, nil]
       date_accessor :issued_at
 
       # Date and time at which the state of the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) was most recently synced from Seam to the provider.
+      # @return [Time, nil]
       date_accessor :latest_desired_state_synced_with_provider_at
     end
   end

data/lib/seam/resources/acs_encoder.rb

@@ -19,26 +19,37 @@ module Seam
     class AcsEncoder < BaseResource
       class Errors < BaseResource
         # Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
+        # @return [String]
         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
 
+      # Errors associated with the [encoder](https://docs.seam.co/low-level-apis/access-systems/working-with-card-encoders-and-scanners).
+      # @return [Array<Errors>]
       resource_list_accessor :errors, Errors
       # ID of the [encoder](https://docs.seam.co/low-level-apis/access-systems/working-with-card-encoders-and-scanners).
+      # @return [String]
       attr_accessor :acs_encoder_id
       # ID of the [access control system](https://docs.seam.co/low-level-apis/access-systems) that contains the [encoder](https://docs.seam.co/low-level-apis/access-systems/working-with-card-encoders-and-scanners).
+      # @return [String]
       attr_accessor :acs_system_id
       # ID of the connected account that contains the [encoder](https://docs.seam.co/low-level-apis/access-systems/working-with-card-encoders-and-scanners).
+      # @return [String]
       attr_accessor :connected_account_id
       # Display name for the [encoder](https://docs.seam.co/low-level-apis/access-systems/working-with-card-encoders-and-scanners).
+      # @return [String]
       attr_accessor :display_name
       # ID of the workspace that contains the [encoder](https://docs.seam.co/low-level-apis/access-systems/working-with-card-encoders-and-scanners).
+      # @return [String]
       attr_accessor :workspace_id
 
       # Date and time at which the [encoder](https://docs.seam.co/low-level-apis/access-systems/working-with-card-encoders-and-scanners) was created.
+      # @return [Time]
       date_accessor :created_at
     end
   end