@seamapi/types 1.444.1 → 1.445.1

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

@@ -11188,41 +11188,41 @@ export interface Routes {
     }
     formData: {}
     jsonResponse: {
-      /** Represents an access grant. Access grants enable you to grant a user identity access to spaces, entrances, and devices through one or more access methods, such as mobile keys, plastic cards, and PIN codes. You can create an access grant for an existing user identity, or you can create a new user identity *while* creating the new access grant. */
+      /** Represents an Access Grant. Access Grants enable you to grant a user identity access to spaces, entrances, and devices through one or more access methods, such as mobile keys, plastic cards, and PIN codes. You can create an Access Grant for an existing user identity, or you can create a new user identity *while* creating the new Access Grant. */
       access_grant: {
-        /** ID of the Seam workspace associated with the access grant. */
+        /** ID of the Seam workspace associated with the Access Grant. */
         workspace_id: string
-        /** ID of the access grant. */
+        /** ID of the Access Grant. */
         access_grant_id: string
-        /** ID of user identity to which the access grant gives access. */
+        /** ID of user identity to which the Access Grant gives access. */
         user_identity_id: string
         /**
          * @deprecated Use `space_ids`. */
         location_ids: string[]
-        /** IDs of the spaces to which the access grant gives access. */
+        /** IDs of the spaces to which the Access Grant gives access. */
         space_ids: string[]
-        /** Access methods that the user requested for the access grant. */
+        /** Access methods that the user requested for the Access Grant. */
         requested_access_methods: Array<{
           /** Display name of the access method. */
           display_name: string
           /** Access method mode. Supported values: `code`, `card`, `mobile_key`. */
           mode: 'code' | 'card' | 'mobile_key'
-          /** Date and time at which the requested access method was added to the access grant. */
+          /** Date and time at which the requested access method was added to the Access Grant. */
           created_at: string
           /** IDs of the access methods created for the requested access method. */
           created_access_method_ids: string[]
         }>
-        /** IDs of the access methods created for the access grant. */
+        /** IDs of the access methods created for the Access Grant. */
         access_method_ids: string[]
-        /** Display name of the access grant. */
+        /** Display name of the Access Grant. */
         display_name: string
-        /** Instant Key URL. Only returned if the access grant has a single mobile_key access_method.  */
+        /** Instant Key URL. Only returned if the Access Grant has a single mobile_key access_method.  */
         instant_key_url?: string | undefined
-        /** Date and time at which the access grant was created. */
+        /** Date and time at which the Access Grant was created. */
         created_at: string
-        /** Date and time at which the access grant starts. */
+        /** Date and time at which the Access Grant starts. */
         starts_at?: string | undefined
-        /** Date and time at which the access grant ends. */
+        /** Date and time at which the Access Grant ends. */
         ends_at?: string | undefined
       }
     }
@@ -11233,7 +11233,7 @@ export interface Routes {
     queryParams: {}
     jsonBody: {}
     commonParams: {
-      /** ID of access grant to delete. */
+      /** ID of Access Grant to delete. */
       access_grant_id: string
     }
     formData: {}
@@ -11245,46 +11245,46 @@ export interface Routes {
     queryParams: {}
     jsonBody: {}
     commonParams: {
-      /** ID of access grant to get. */
+      /** ID of Access Grant to get. */
       access_grant_id: string
     }
     formData: {}
     jsonResponse: {
-      /** Represents an access grant. Access grants enable you to grant a user identity access to spaces, entrances, and devices through one or more access methods, such as mobile keys, plastic cards, and PIN codes. You can create an access grant for an existing user identity, or you can create a new user identity *while* creating the new access grant. */
+      /** Represents an Access Grant. Access Grants enable you to grant a user identity access to spaces, entrances, and devices through one or more access methods, such as mobile keys, plastic cards, and PIN codes. You can create an Access Grant for an existing user identity, or you can create a new user identity *while* creating the new Access Grant. */
       access_grant: {
-        /** ID of the Seam workspace associated with the access grant. */
+        /** ID of the Seam workspace associated with the Access Grant. */
         workspace_id: string
-        /** ID of the access grant. */
+        /** ID of the Access Grant. */
         access_grant_id: string
-        /** ID of user identity to which the access grant gives access. */
+        /** ID of user identity to which the Access Grant gives access. */
         user_identity_id: string
         /**
          * @deprecated Use `space_ids`. */
         location_ids: string[]
-        /** IDs of the spaces to which the access grant gives access. */
+        /** IDs of the spaces to which the Access Grant gives access. */
         space_ids: string[]
-        /** Access methods that the user requested for the access grant. */
+        /** Access methods that the user requested for the Access Grant. */
         requested_access_methods: Array<{
           /** Display name of the access method. */
           display_name: string
           /** Access method mode. Supported values: `code`, `card`, `mobile_key`. */
           mode: 'code' | 'card' | 'mobile_key'
-          /** Date and time at which the requested access method was added to the access grant. */
+          /** Date and time at which the requested access method was added to the Access Grant. */
           created_at: string
           /** IDs of the access methods created for the requested access method. */
           created_access_method_ids: string[]
         }>
-        /** IDs of the access methods created for the access grant. */
+        /** IDs of the access methods created for the Access Grant. */
         access_method_ids: string[]
-        /** Display name of the access grant. */
+        /** Display name of the Access Grant. */
         display_name: string
-        /** Instant Key URL. Only returned if the access grant has a single mobile_key access_method.  */
+        /** Instant Key URL. Only returned if the Access Grant has a single mobile_key access_method.  */
         instant_key_url?: string | undefined
-        /** Date and time at which the access grant was created. */
+        /** Date and time at which the Access Grant was created. */
         created_at: string
-        /** Date and time at which the access grant starts. */
+        /** Date and time at which the Access Grant starts. */
         starts_at?: string | undefined
-        /** Date and time at which the access grant ends. */
+        /** Date and time at which the Access Grant ends. */
         ends_at?: string | undefined
       }
     }
@@ -11295,54 +11295,54 @@ export interface Routes {
     queryParams: {}
     jsonBody: {}
     commonParams: {
-      /** ID of user identity to filter list of access grants by. */
+      /** ID of user identity by which you want to filter the list of Access Grants. */
       user_identity_id?: string | undefined
-      /** ID of system to filter list of access grants by. */
+      /** ID of the access system by which you want to filter the list of Access Grants. */
       acs_system_id?: string | undefined
-      /** ID of entrance to filter list of access grants by. */
+      /** ID of the entrance by which you want to filter the list of Access Grants. */
       acs_entrance_id?: string | undefined
       /**
        * @deprecated Use `space_id`. */
       location_id?: string | undefined
-      /** ID of space to filter list of access grants by. */
+      /** ID of the space by which you want to filter the list of Access Grants. */
       space_id?: string | undefined
     }
     formData: {}
     jsonResponse: {
       access_grants: Array<{
-        /** ID of the Seam workspace associated with the access grant. */
+        /** ID of the Seam workspace associated with the Access Grant. */
         workspace_id: string
-        /** ID of the access grant. */
+        /** ID of the Access Grant. */
         access_grant_id: string
-        /** ID of user identity to which the access grant gives access. */
+        /** ID of user identity to which the Access Grant gives access. */
         user_identity_id: string
         /**
          * @deprecated Use `space_ids`. */
         location_ids: string[]
-        /** IDs of the spaces to which the access grant gives access. */
+        /** IDs of the spaces to which the Access Grant gives access. */
         space_ids: string[]
-        /** Access methods that the user requested for the access grant. */
+        /** Access methods that the user requested for the Access Grant. */
         requested_access_methods: Array<{
           /** Display name of the access method. */
           display_name: string
           /** Access method mode. Supported values: `code`, `card`, `mobile_key`. */
           mode: 'code' | 'card' | 'mobile_key'
-          /** Date and time at which the requested access method was added to the access grant. */
+          /** Date and time at which the requested access method was added to the Access Grant. */
           created_at: string
           /** IDs of the access methods created for the requested access method. */
           created_access_method_ids: string[]
         }>
-        /** IDs of the access methods created for the access grant. */
+        /** IDs of the access methods created for the Access Grant. */
         access_method_ids: string[]
-        /** Display name of the access grant. */
+        /** Display name of the Access Grant. */
         display_name: string
-        /** Instant Key URL. Only returned if the access grant has a single mobile_key access_method.  */
+        /** Instant Key URL. Only returned if the Access Grant has a single mobile_key access_method.  */
         instant_key_url?: string | undefined
-        /** Date and time at which the access grant was created. */
+        /** Date and time at which the Access Grant was created. */
         created_at: string
-        /** Date and time at which the access grant starts. */
+        /** Date and time at which the Access Grant starts. */
         starts_at?: string | undefined
-        /** Date and time at which the access grant ends. */
+        /** Date and time at which the Access Grant ends. */
         ends_at?: string | undefined
       }>
     }
@@ -11353,7 +11353,7 @@ export interface Routes {
     queryParams: {}
     jsonBody: {}
     commonParams: {
-      /** ID of the access grant to update. */
+      /** ID of the Access Grant to update. */
       access_grant_id: string
       /** Date and time at which the validity of the grant starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. */
       starts_at?: (string | null) | undefined
@@ -11381,7 +11381,7 @@ export interface Routes {
     queryParams: {}
     jsonBody: {}
     commonParams: {
-      /** ID of the `acs_encoder` to use to encode the `acs_credential`. */
+      /** ID of the `acs_encoder` to use to encode the `access_method`. */
       acs_encoder_id: string
       /** ID of the `access_method` to encode onto a card. */
       access_method_id: string
@@ -12827,7 +12827,7 @@ export interface Routes {
     }
     formData: {}
     jsonResponse: {
-      /** Represents an access method for an access grant. Access methods describe the modes of access, such as PIN codes, plastic cards, and mobile keys. For a mobile key, the access method also stores the URL for the associated Instant Key. */
+      /** Represents an access method for an Access Grant. Access methods describe the modes of access, such as PIN codes, plastic cards, and mobile keys. For a mobile key, the access method also stores the URL for the associated Instant Key. */
       access_method: {
         /** ID of the Seam workspace associated with the access method. */
         workspace_id: string
@@ -12856,7 +12856,7 @@ export interface Routes {
     queryParams: {}
     jsonBody: {}
     commonParams: {
-      /** ID of access grant to list access methods for. */
+      /** ID of Access Grant to list access methods for. */
       access_grant_id: string
       /** ID of the device for which you want to retrieve all access methods. */
       device_id?: string | undefined
@@ -24340,7 +24340,8 @@ export interface Routes {
       custom_redirect_url?: string | undefined
       /** Alternative URL that you want to redirect the user to on an error. If you do not set this parameter, the Connect Webview falls back to the `custom_redirect_url`. */
       custom_redirect_failure_url?: string | undefined
-      customer_id?: string | undefined
+      /** Optional unique string key that can be used to identify the customer. If provided, the customer will be created or retrieved based on this key. */
+      customer_key?: string | undefined
       /** Accepted device provider keys as an alternative to `provider_category`. Use this parameter to specify accepted providers explicitly. See [Customize the Brands to Display in Your Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-brands-to-display-in-your-connect-webviews). To list all provider keys, use [`/devices/list_device_providers`](https://docs.seam.co/latest/api/devices/list_device_providers) with no filters. */
       accepted_providers?:
         | Array<
@@ -24476,6 +24477,8 @@ export interface Routes {
         authorized_at: string | null
         /** Selected provider of the Connect Webview, one of the [provider keys](https://docs.seam.co/latest/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-brands-to-display-in-your-connect-webviews). */
         selected_provider: string | null
+        /** The customer key associated with this webview, if any. */
+        customer_key?: string | undefined
       }
     }
   }
@@ -24557,6 +24560,8 @@ export interface Routes {
         authorized_at: string | null
         /** Selected provider of the Connect Webview, one of the [provider keys](https://docs.seam.co/latest/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-brands-to-display-in-your-connect-webviews). */
         selected_provider: string | null
+        /** The customer key associated with this webview, if any. */
+        customer_key?: string | undefined
       }
     }
   }
@@ -24566,7 +24571,6 @@ export interface Routes {
     queryParams: {}
     jsonBody: {}
     commonParams: {
-      customer_ids?: string[] | undefined
       /** Your user ID for the user by which you want to filter Connect Webviews. */
       user_identifier_key?: string | undefined
       /** Custom metadata pairs by which you want to [filter Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews/filtering-connect-webviews-by-custom-metadata). Returns Connect Webviews with `custom_metadata` that contains all of the provided key:value pairs. */
@@ -24622,6 +24626,8 @@ export interface Routes {
         authorized_at: string | null
         /** Selected provider of the Connect Webview, one of the [provider keys](https://docs.seam.co/latest/core-concepts/connect-webviews/customizing-connect-webviews#customize-the-brands-to-display-in-your-connect-webviews). */
         selected_provider: string | null
+        /** The customer key associated with this webview, if any. */
+        customer_key?: string | undefined
       }>
       /** Information about the current page of results. */
       pagination: {
@@ -30701,7 +30707,7 @@ export interface Routes {
                 created_at: string
                 /** Date and time at which the event occurred. */
                 occurred_at: string
-                /** ID of the affected access grant. */
+                /** ID of the affected Access Grant. */
                 access_grant_id: string
                 event_type: 'access_grant.created'
               }
@@ -30714,7 +30720,7 @@ export interface Routes {
                 created_at: string
                 /** Date and time at which the event occurred. */
                 occurred_at: string
-                /** ID of the affected access grant. */
+                /** ID of the affected Access Grant. */
                 access_grant_id: string
                 event_type: 'access_grant.deleted'
               }
@@ -30727,7 +30733,7 @@ export interface Routes {
                 created_at: string
                 /** Date and time at which the event occurred. */
                 occurred_at: string
-                /** ID of the affected access grant. */
+                /** ID of the affected Access Grant. */
                 access_grant_id: string
                 event_type: 'access_grant.access_granted_to_all_doors'
               }
@@ -30740,7 +30746,7 @@ export interface Routes {
                 created_at: string
                 /** Date and time at which the event occurred. */
                 occurred_at: string
-                /** ID of the affected access grant. */
+                /** ID of the affected Access Grant. */
                 access_grant_id: string
                 event_type: 'access_grant.access_granted_to_door'
                 /** ID of the affected [entrance](https://docs.seam.co/latest/capability-guides/retrieving-entrance-details). */
@@ -30755,7 +30761,7 @@ export interface Routes {
                 created_at: string
                 /** Date and time at which the event occurred. */
                 occurred_at: string
-                /** ID of the affected access grant. */
+                /** ID of the affected Access Grant. */
                 access_grant_id: string
                 event_type: 'access_grant.access_to_door_lost'
                 /** ID of the affected [entrance](https://docs.seam.co/latest/capability-guides/retrieving-entrance-details). */
@@ -32869,7 +32875,7 @@ export interface Routes {
             created_at: string
             /** Date and time at which the event occurred. */
             occurred_at: string
-            /** ID of the affected access grant. */
+            /** ID of the affected Access Grant. */
             access_grant_id: string
             event_type: 'access_grant.created'
           }
@@ -32882,7 +32888,7 @@ export interface Routes {
             created_at: string
             /** Date and time at which the event occurred. */
             occurred_at: string
-            /** ID of the affected access grant. */
+            /** ID of the affected Access Grant. */
             access_grant_id: string
             event_type: 'access_grant.deleted'
           }
@@ -32895,7 +32901,7 @@ export interface Routes {
             created_at: string
             /** Date and time at which the event occurred. */
             occurred_at: string
-            /** ID of the affected access grant. */
+            /** ID of the affected Access Grant. */
             access_grant_id: string
             event_type: 'access_grant.access_granted_to_all_doors'
           }
@@ -32908,7 +32914,7 @@ export interface Routes {
             created_at: string
             /** Date and time at which the event occurred. */
             occurred_at: string
-            /** ID of the affected access grant. */
+            /** ID of the affected Access Grant. */
             access_grant_id: string
             event_type: 'access_grant.access_granted_to_door'
             /** ID of the affected [entrance](https://docs.seam.co/latest/capability-guides/retrieving-entrance-details). */
@@ -32923,7 +32929,7 @@ export interface Routes {
             created_at: string
             /** Date and time at which the event occurred. */
             occurred_at: string
-            /** ID of the affected access grant. */
+            /** ID of the affected Access Grant. */
             access_grant_id: string
             event_type: 'access_grant.access_to_door_lost'
             /** ID of the affected [entrance](https://docs.seam.co/latest/capability-guides/retrieving-entrance-details). */
@@ -74718,41 +74724,41 @@ export interface Routes {
     }
     formData: {}
     jsonResponse: {
-      /** Represents an access grant. Access grants enable you to grant a user identity access to spaces, entrances, and devices through one or more access methods, such as mobile keys, plastic cards, and PIN codes. You can create an access grant for an existing user identity, or you can create a new user identity *while* creating the new access grant. */
+      /** Represents an Access Grant. Access Grants enable you to grant a user identity access to spaces, entrances, and devices through one or more access methods, such as mobile keys, plastic cards, and PIN codes. You can create an Access Grant for an existing user identity, or you can create a new user identity *while* creating the new Access Grant. */
       access_grant: {
-        /** ID of the Seam workspace associated with the access grant. */
+        /** ID of the Seam workspace associated with the Access Grant. */
         workspace_id: string
-        /** ID of the access grant. */
+        /** ID of the Access Grant. */
         access_grant_id: string
-        /** ID of user identity to which the access grant gives access. */
+        /** ID of user identity to which the Access Grant gives access. */
         user_identity_id: string
         /**
          * @deprecated Use `space_ids`. */
         location_ids: string[]
-        /** IDs of the spaces to which the access grant gives access. */
+        /** IDs of the spaces to which the Access Grant gives access. */
         space_ids: string[]
-        /** Access methods that the user requested for the access grant. */
+        /** Access methods that the user requested for the Access Grant. */
         requested_access_methods: Array<{
           /** Display name of the access method. */
           display_name: string
           /** Access method mode. Supported values: `code`, `card`, `mobile_key`. */
           mode: 'code' | 'card' | 'mobile_key'
-          /** Date and time at which the requested access method was added to the access grant. */
+          /** Date and time at which the requested access method was added to the Access Grant. */
           created_at: string
           /** IDs of the access methods created for the requested access method. */
           created_access_method_ids: string[]
         }>
-        /** IDs of the access methods created for the access grant. */
+        /** IDs of the access methods created for the Access Grant. */
         access_method_ids: string[]
-        /** Display name of the access grant. */
+        /** Display name of the Access Grant. */
         display_name: string
-        /** Instant Key URL. Only returned if the access grant has a single mobile_key access_method.  */
+        /** Instant Key URL. Only returned if the Access Grant has a single mobile_key access_method.  */
         instant_key_url?: string | undefined
-        /** Date and time at which the access grant was created. */
+        /** Date and time at which the Access Grant was created. */
         created_at: string
-        /** Date and time at which the access grant starts. */
+        /** Date and time at which the Access Grant starts. */
         starts_at?: string | undefined
-        /** Date and time at which the access grant ends. */
+        /** Date and time at which the Access Grant ends. */
         ends_at?: string | undefined
       }
     }
@@ -74780,41 +74786,41 @@ export interface Routes {
     }
     formData: {}
     jsonResponse: {
-      /** Represents an access grant. Access grants enable you to grant a user identity access to spaces, entrances, and devices through one or more access methods, such as mobile keys, plastic cards, and PIN codes. You can create an access grant for an existing user identity, or you can create a new user identity *while* creating the new access grant. */
+      /** Represents an Access Grant. Access Grants enable you to grant a user identity access to spaces, entrances, and devices through one or more access methods, such as mobile keys, plastic cards, and PIN codes. You can create an Access Grant for an existing user identity, or you can create a new user identity *while* creating the new Access Grant. */
       access_grant: {
-        /** ID of the Seam workspace associated with the access grant. */
+        /** ID of the Seam workspace associated with the Access Grant. */
         workspace_id: string
-        /** ID of the access grant. */
+        /** ID of the Access Grant. */
         access_grant_id: string
-        /** ID of user identity to which the access grant gives access. */
+        /** ID of user identity to which the Access Grant gives access. */
         user_identity_id: string
         /**
          * @deprecated Use `space_ids`. */
         location_ids: string[]
-        /** IDs of the spaces to which the access grant gives access. */
+        /** IDs of the spaces to which the Access Grant gives access. */
         space_ids: string[]
-        /** Access methods that the user requested for the access grant. */
+        /** Access methods that the user requested for the Access Grant. */
         requested_access_methods: Array<{
           /** Display name of the access method. */
           display_name: string
           /** Access method mode. Supported values: `code`, `card`, `mobile_key`. */
           mode: 'code' | 'card' | 'mobile_key'
-          /** Date and time at which the requested access method was added to the access grant. */
+          /** Date and time at which the requested access method was added to the Access Grant. */
           created_at: string
           /** IDs of the access methods created for the requested access method. */
           created_access_method_ids: string[]
         }>
-        /** IDs of the access methods created for the access grant. */
+        /** IDs of the access methods created for the Access Grant. */
         access_method_ids: string[]
-        /** Display name of the access grant. */
+        /** Display name of the Access Grant. */
         display_name: string
-        /** Instant Key URL. Only returned if the access grant has a single mobile_key access_method.  */
+        /** Instant Key URL. Only returned if the Access Grant has a single mobile_key access_method.  */
         instant_key_url?: string | undefined
-        /** Date and time at which the access grant was created. */
+        /** Date and time at which the Access Grant was created. */
         created_at: string
-        /** Date and time at which the access grant starts. */
+        /** Date and time at which the Access Grant starts. */
         starts_at?: string | undefined
-        /** Date and time at which the access grant ends. */
+        /** Date and time at which the Access Grant ends. */
         ends_at?: string | undefined
       }
     }
@@ -74840,39 +74846,39 @@ export interface Routes {
     formData: {}
     jsonResponse: {
       access_grants: Array<{
-        /** ID of the Seam workspace associated with the access grant. */
+        /** ID of the Seam workspace associated with the Access Grant. */
         workspace_id: string
-        /** ID of the access grant. */
+        /** ID of the Access Grant. */
         access_grant_id: string
-        /** ID of user identity to which the access grant gives access. */
+        /** ID of user identity to which the Access Grant gives access. */
         user_identity_id: string
         /**
          * @deprecated Use `space_ids`. */
         location_ids: string[]
-        /** IDs of the spaces to which the access grant gives access. */
+        /** IDs of the spaces to which the Access Grant gives access. */
         space_ids: string[]
-        /** Access methods that the user requested for the access grant. */
+        /** Access methods that the user requested for the Access Grant. */
         requested_access_methods: Array<{
           /** Display name of the access method. */
           display_name: string
           /** Access method mode. Supported values: `code`, `card`, `mobile_key`. */
           mode: 'code' | 'card' | 'mobile_key'
-          /** Date and time at which the requested access method was added to the access grant. */
+          /** Date and time at which the requested access method was added to the Access Grant. */
           created_at: string
           /** IDs of the access methods created for the requested access method. */
           created_access_method_ids: string[]
         }>
-        /** IDs of the access methods created for the access grant. */
+        /** IDs of the access methods created for the Access Grant. */
         access_method_ids: string[]
-        /** Display name of the access grant. */
+        /** Display name of the Access Grant. */
         display_name: string
-        /** Instant Key URL. Only returned if the access grant has a single mobile_key access_method.  */
+        /** Instant Key URL. Only returned if the Access Grant has a single mobile_key access_method.  */
         instant_key_url?: string | undefined
-        /** Date and time at which the access grant was created. */
+        /** Date and time at which the Access Grant was created. */
         created_at: string
-        /** Date and time at which the access grant starts. */
+        /** Date and time at which the Access Grant starts. */
         starts_at?: string | undefined
-        /** Date and time at which the access grant ends. */
+        /** Date and time at which the Access Grant ends. */
         ends_at?: string | undefined
       }>
     }
@@ -74900,7 +74906,7 @@ export interface Routes {
     }
     formData: {}
     jsonResponse: {
-      /** Represents an access method for an access grant. Access methods describe the modes of access, such as PIN codes, plastic cards, and mobile keys. For a mobile key, the access method also stores the URL for the associated Instant Key. */
+      /** Represents an access method for an Access Grant. Access methods describe the modes of access, such as PIN codes, plastic cards, and mobile keys. For a mobile key, the access method also stores the URL for the associated Instant Key. */
       access_method: {
         /** ID of the Seam workspace associated with the access method. */
         workspace_id: string