@seamapi/types 1.377.0 → 1.379.0

package/src/lib/seam/connect/route-types.ts

@@ -9594,14 +9594,17 @@ export interface Routes {
           | Array<
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'creating'
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'deleting'
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_user_information'
                   from: {
                     email_address?: (string | null) | undefined
@@ -9616,22 +9619,20 @@ export interface Routes {
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_access_schedule'
                   from: {
-                    /** 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. */
-                    starts_at: string
-                    /** 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. */
+                    starts_at: string | null
                     ends_at: string | null
                   }
                   to: {
-                    /** 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. */
-                    starts_at: string
-                    /** 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. */
+                    starts_at: string | null
                     ends_at: string | null
                   }
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_suspension_state'
                   from: {
                     is_suspended: boolean
@@ -9642,6 +9643,7 @@ export interface Routes {
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_group_membership'
                   from: {
                     acs_access_group_id: string | null
@@ -12568,6 +12570,54 @@ export interface Routes {
           }
     }
   }
+  '/acs/encoders/get': {
+    route: '/acs/encoders/get'
+    method: 'GET' | 'POST'
+    queryParams: {}
+    jsonBody: {}
+    commonParams: {
+      /** ID of the desired encoder. */
+      acs_encoder_id: string
+    }
+    formData: {}
+    jsonResponse: {
+      /** Represents a hardware device that encodes [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) data onto physical cards within an [access control system](https://docs.seam.co/latest/capability-guides/access-systems).
+    
+    Some access control systems require credentials to be encoded onto plastic key cards using a card encoder. This process involves the following two key steps:
+    
+    1. Credential creation
+       Configure the access parameters for the credential.
+    2. Card encoding
+       Write the credential data onto the card using a compatible card encoder.
+    
+    Separately, the Seam API also supports card scanning, which enables you to scan and read the encoded data on a card. You can use this action to confirm consistency with access control system records or diagnose discrepancies if needed.
+    
+     See [Working with Card Encoders and Scanners](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners).
+    
+    To verify if your access control system requires a card encoder, see the corresponding [system integration guide](https://docs.seam.co/latest/device-and-system-integration-guides/overview#access-control-systems). */
+      acs_encoder: {
+        /** ID of the [encoder](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners. */
+        acs_encoder_id: string
+        /** ID of the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) that contains the [encoder](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners). */
+        acs_system_id: string
+        /** ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the [encoder](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners). */
+        workspace_id: string
+        /** Errors associated with the [encoder](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners). */
+        errors: Array<{
+          /** Date and time at which Seam created the error. */
+          created_at: string
+          /** Detailed description of the error. Provides insights into the issue and potentially how to rectify it. */
+          message: string
+          /** Unique identifier of the type of error. Enables quick recognition and categorization of the issue. */
+          error_code: 'acs_encoder_removed'
+        }>
+        /** Date and time at which the [encoder](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners) was created. */
+        created_at: string
+        /** Display name for the [encoder](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners). */
+        display_name: string
+      }
+    }
+  }
   '/acs/encoders/list': {
     route: '/acs/encoders/list'
     method: 'GET' | 'POST'
@@ -14923,14 +14973,17 @@ export interface Routes {
           | Array<
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'creating'
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'deleting'
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_user_information'
                   from: {
                     email_address?: (string | null) | undefined
@@ -14945,22 +14998,20 @@ export interface Routes {
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_access_schedule'
                   from: {
-                    /** 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. */
-                    starts_at: string
-                    /** 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. */
+                    starts_at: string | null
                     ends_at: string | null
                   }
                   to: {
-                    /** 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. */
-                    starts_at: string
-                    /** 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. */
+                    starts_at: string | null
                     ends_at: string | null
                   }
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_suspension_state'
                   from: {
                     is_suspended: boolean
@@ -14971,6 +15022,7 @@ export interface Routes {
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_group_membership'
                   from: {
                     acs_access_group_id: string | null
@@ -15142,14 +15194,17 @@ export interface Routes {
           | Array<
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'creating'
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'deleting'
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_user_information'
                   from: {
                     email_address?: (string | null) | undefined
@@ -15164,22 +15219,20 @@ export interface Routes {
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_access_schedule'
                   from: {
-                    /** 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. */
-                    starts_at: string
-                    /** 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. */
+                    starts_at: string | null
                     ends_at: string | null
                   }
                   to: {
-                    /** 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. */
-                    starts_at: string
-                    /** 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. */
+                    starts_at: string | null
                     ends_at: string | null
                   }
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_suspension_state'
                   from: {
                     is_suspended: boolean
@@ -15190,6 +15243,7 @@ export interface Routes {
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_group_membership'
                   from: {
                     acs_access_group_id: string | null
@@ -15357,14 +15411,17 @@ export interface Routes {
           | Array<
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'creating'
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'deleting'
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_user_information'
                   from: {
                     email_address?: (string | null) | undefined
@@ -15379,22 +15436,20 @@ export interface Routes {
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_access_schedule'
                   from: {
-                    /** 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. */
-                    starts_at: string
-                    /** 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. */
+                    starts_at: string | null
                     ends_at: string | null
                   }
                   to: {
-                    /** 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. */
-                    starts_at: string
-                    /** 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. */
+                    starts_at: string | null
                     ends_at: string | null
                   }
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_suspension_state'
                   from: {
                     is_suspended: boolean
@@ -15405,6 +15460,7 @@ export interface Routes {
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_group_membership'
                   from: {
                     acs_access_group_id: string | null
@@ -15704,14 +15760,17 @@ export interface Routes {
           | Array<
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'creating'
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'deleting'
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_user_information'
                   from: {
                     email_address?: (string | null) | undefined
@@ -15726,22 +15785,20 @@ export interface Routes {
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_access_schedule'
                   from: {
-                    /** 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. */
-                    starts_at: string
-                    /** 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. */
+                    starts_at: string | null
                     ends_at: string | null
                   }
                   to: {
-                    /** 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. */
-                    starts_at: string
-                    /** 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. */
+                    starts_at: string | null
                     ends_at: string | null
                   }
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_suspension_state'
                   from: {
                     is_suspended: boolean
@@ -15752,6 +15809,7 @@ export interface Routes {
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_group_membership'
                   from: {
                     acs_access_group_id: string | null
@@ -15909,14 +15967,17 @@ export interface Routes {
           | Array<
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'creating'
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'deleting'
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_user_information'
                   from: {
                     email_address?: (string | null) | undefined
@@ -15931,22 +15992,20 @@ export interface Routes {
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_access_schedule'
                   from: {
-                    /** 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. */
-                    starts_at: string
-                    /** 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. */
+                    starts_at: string | null
                     ends_at: string | null
                   }
                   to: {
-                    /** 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. */
-                    starts_at: string
-                    /** 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. */
+                    starts_at: string | null
                     ends_at: string | null
                   }
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_suspension_state'
                   from: {
                     is_suspended: boolean
@@ -15957,6 +16016,7 @@ export interface Routes {
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_group_membership'
                   from: {
                     acs_access_group_id: string | null
@@ -36885,15 +36945,15 @@ export interface Routes {
               /** Unique identifier of the type of error. Enables quick recognition and categorization of the issue. */
               error_code: 'bridge_lan_unreachable'
               /** Seam cannot reach the tailscale proxy */
-              is_tailscale_proxy_reachable: boolean
+              is_tailscale_proxy_reachable: boolean | null
               /** Tailscale proxy's SOCKS server is unhealthy */
-              is_tailscale_proxy_socks_server_healthy: boolean
+              is_tailscale_proxy_socks_server_healthy: boolean | null
               /** Tailscale proxy cannot reach the Tailscale network */
-              can_tailscale_proxy_reach_tailscale_network: boolean
+              can_tailscale_proxy_reach_tailscale_network: boolean | null
               /** Tailscale proxy cannot reach the bridge */
-              can_tailscale_proxy_reach_bridge: boolean
+              can_tailscale_proxy_reach_bridge: boolean | null
               /** Bridge's SOCKS server is unhealthy */
-              is_bridge_socks_server_healthy: boolean
+              is_bridge_socks_server_healthy: boolean | null
             }
           | {
               message: string
@@ -36932,15 +36992,15 @@ export interface Routes {
               /** Unique identifier of the type of error. Enables quick recognition and categorization of the issue. */
               error_code: 'bridge_lan_unreachable'
               /** Seam cannot reach the tailscale proxy */
-              is_tailscale_proxy_reachable: boolean
+              is_tailscale_proxy_reachable: boolean | null
               /** Tailscale proxy's SOCKS server is unhealthy */
-              is_tailscale_proxy_socks_server_healthy: boolean
+              is_tailscale_proxy_socks_server_healthy: boolean | null
               /** Tailscale proxy cannot reach the Tailscale network */
-              can_tailscale_proxy_reach_tailscale_network: boolean
+              can_tailscale_proxy_reach_tailscale_network: boolean | null
               /** Tailscale proxy cannot reach the bridge */
-              can_tailscale_proxy_reach_bridge: boolean
+              can_tailscale_proxy_reach_bridge: boolean | null
               /** Bridge's SOCKS server is unhealthy */
-              is_bridge_socks_server_healthy: boolean
+              is_bridge_socks_server_healthy: boolean | null
             }
           | {
               message: string
@@ -36979,15 +37039,15 @@ export interface Routes {
               /** Unique identifier of the type of error. Enables quick recognition and categorization of the issue. */
               error_code: 'bridge_lan_unreachable'
               /** Seam cannot reach the tailscale proxy */
-              is_tailscale_proxy_reachable: boolean
+              is_tailscale_proxy_reachable: boolean | null
               /** Tailscale proxy's SOCKS server is unhealthy */
-              is_tailscale_proxy_socks_server_healthy: boolean
+              is_tailscale_proxy_socks_server_healthy: boolean | null
               /** Tailscale proxy cannot reach the Tailscale network */
-              can_tailscale_proxy_reach_tailscale_network: boolean
+              can_tailscale_proxy_reach_tailscale_network: boolean | null
               /** Tailscale proxy cannot reach the bridge */
-              can_tailscale_proxy_reach_bridge: boolean
+              can_tailscale_proxy_reach_bridge: boolean | null
               /** Bridge's SOCKS server is unhealthy */
-              is_bridge_socks_server_healthy: boolean
+              is_bridge_socks_server_healthy: boolean | null
             }
           | {
               message: string
@@ -50894,14 +50954,17 @@ export interface Routes {
           | Array<
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'creating'
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'deleting'
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_user_information'
                   from: {
                     email_address?: (string | null) | undefined
@@ -50916,22 +50979,20 @@ export interface Routes {
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_access_schedule'
                   from: {
-                    /** 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. */
-                    starts_at: string
-                    /** 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. */
+                    starts_at: string | null
                     ends_at: string | null
                   }
                   to: {
-                    /** 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. */
-                    starts_at: string
-                    /** 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. */
+                    starts_at: string | null
                     ends_at: string | null
                   }
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_suspension_state'
                   from: {
                     is_suspended: boolean
@@ -50942,6 +51003,7 @@ export interface Routes {
                 }
               | {
                   created_at: string
+                  message: string
                   mutation_code: 'updating_group_membership'
                   from: {
                     acs_access_group_id: string | null