@seamapi/types 1.444.1 → 1.445.1

package/src/lib/seam/connect/models/access-grants/requested-access-method.ts

@@ -11,7 +11,7 @@ export const requested_access_method = z.object({
     .string()
     .datetime()
     .describe(
-      '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_access_method_ids: z
     .array(z.string().uuid())

package/src/lib/seam/connect/models/connect-webviews/connect-webview.ts

@@ -117,6 +117,10 @@ export const connect_webview = z.object({
     .describe(
       '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).',
     ),
+  customer_key: z
+    .string()
+    .optional()
+    .describe('The customer key associated with this webview, if any.'),
 }).describe(`
   ---
   route_path: /connect_webviews

package/src/lib/seam/connect/models/events/access-grants.ts

@@ -6,7 +6,7 @@ const access_grant_event = common_event.extend({
   access_grant_id: z
     .string()
     .uuid()
-    .describe('ID of the affected access grant.'),
+    .describe('ID of the affected Access Grant.'),
 })
 
 export const access_grant_created_event = access_grant_event.extend({
@@ -15,7 +15,7 @@ export const access_grant_created_event = access_grant_event.extend({
     ---
     route_path: /access_grants
     ---
-    An access grant was created.
+    An Access Grant was created.
   `)
 
 export const access_grant_deleted_event = access_grant_event.extend({
@@ -24,7 +24,7 @@ export const access_grant_deleted_event = access_grant_event.extend({
     ---
     route_path: /access_grants
     ---
-    An access grant was deleted.
+    An Access Grant was deleted.
   `)
 
 export const access_grant_access_granted_to_all_doors_event =
@@ -34,7 +34,7 @@ export const access_grant_access_granted_to_all_doors_event =
     ---
     route_path: /access_grants
     ---
-    All access requested for an access grant was successfully granted.
+    All access requested for an Access Grant was successfully granted.
   `)
 
 export type AccessGrantAccessGrantedToAllDoorsEvent = z.infer<
@@ -56,7 +56,7 @@ export const access_grant_access_granted_to_door_event =
     ---
     route_path: /access_grants
     ---
-    Access requested as part of an access grant to a particular door was successfully granted.
+    Access requested as part of an Access Grant to a particular door was successfully granted.
   `)
 
 export type AccessGrantAccessGrantedToDoorEvent = z.infer<
@@ -72,7 +72,7 @@ export const access_grant_access_to_door_lost_event = access_grant_event.extend(
     ---
     route_path: /access_grants
     ---
-    Access to a particular door that was requested as part of an access grant was lost.
+    Access to a particular door that was requested as part of an Access Grant was lost.
   `)
 
 export type AccessGrantAccessToDoorLostEvent = z.infer<

package/src/lib/seam/connect/models/events/access-methods.ts

@@ -58,7 +58,7 @@ export const access_method_reissued_event = access_method_event.extend({
     ---
     route_path: /access_methods
     ---
-    An access method was reissued due to an access grant update.
+    An access method was reissued due to an Access Grant update.
   `)
 
 export type AccessMethodRevokedEvent = z.infer<

package/src/lib/seam/connect/openapi.ts

@@ -1815,36 +1815,36 @@ export default {
       },
       access_grant: {
         description:
-          '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.',
         properties: {
           access_grant_id: {
-            description: 'ID of the access grant.',
+            description: 'ID of the Access Grant.',
             format: 'uuid',
             type: 'string',
           },
           access_method_ids: {
             description:
-              'IDs of the access methods created for the access grant.',
+              'IDs of the access methods created for the Access Grant.',
             items: { format: 'uuid', type: 'string' },
             type: 'array',
           },
           created_at: {
-            description: 'Date and time at which the access grant was created.',
+            description: 'Date and time at which the Access Grant was created.',
             format: 'date-time',
             type: 'string',
           },
           display_name: {
-            description: 'Display name of the access grant.',
+            description: 'Display name of the Access Grant.',
             type: 'string',
           },
           ends_at: {
-            description: 'Date and time at which the access grant ends.',
+            description: 'Date and time at which the Access Grant ends.',
             format: 'date-time',
             type: 'string',
           },
           instant_key_url: {
             description:
-              '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. ',
             format: 'uri',
             type: 'string',
           },
@@ -1856,7 +1856,7 @@ export default {
           },
           requested_access_methods: {
             description:
-              'Access methods that the user requested for the access grant.',
+              'Access methods that the user requested for the Access Grant.',
             items: {
               properties: {
                 created_access_method_ids: {
@@ -1867,7 +1867,7 @@ export default {
                 },
                 created_at: {
                   description:
-                    '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.',
                   format: 'date-time',
                   type: 'string',
                 },
@@ -1894,24 +1894,24 @@ export default {
           },
           space_ids: {
             description:
-              'IDs of the spaces to which the access grant gives access.',
+              'IDs of the spaces to which the Access Grant gives access.',
             items: { format: 'uuid', type: 'string' },
             type: 'array',
           },
           starts_at: {
-            description: 'Date and time at which the access grant starts.',
+            description: 'Date and time at which the Access Grant starts.',
             format: 'date-time',
             type: 'string',
           },
           user_identity_id: {
             description:
-              'ID of user identity to which the access grant gives access.',
+              'ID of user identity to which the Access Grant gives access.',
             format: 'uuid',
             type: 'string',
           },
           workspace_id: {
             description:
-              'ID of the Seam workspace associated with the access grant.',
+              'ID of the Seam workspace associated with the Access Grant.',
             format: 'uuid',
             type: 'string',
           },
@@ -1933,7 +1933,7 @@ export default {
       },
       access_method: {
         description:
-          '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.',
         properties: {
           access_method_id: {
             description: 'ID of the access method.',
@@ -8633,6 +8633,11 @@ export default {
             nullable: true,
             type: 'string',
           },
+          customer_key: {
+            description:
+              'The customer key associated with this webview, if any.',
+            type: 'string',
+          },
           device_selection_mode: {
             enum: ['none', 'single', 'multiple'],
             type: 'string',
@@ -14222,10 +14227,10 @@ export default {
             'x-route-path': '/access_codes/unmanaged',
           },
           {
-            description: 'An access grant was created.',
+            description: 'An Access Grant was created.',
             properties: {
               access_grant_id: {
-                description: 'ID of the affected access grant.',
+                description: 'ID of the affected Access Grant.',
                 format: 'uuid',
                 type: 'string',
               },
@@ -14264,10 +14269,10 @@ export default {
             'x-route-path': '/access_grants',
           },
           {
-            description: 'An access grant was deleted.',
+            description: 'An Access Grant was deleted.',
             properties: {
               access_grant_id: {
-                description: 'ID of the affected access grant.',
+                description: 'ID of the affected Access Grant.',
                 format: 'uuid',
                 type: 'string',
               },
@@ -14307,10 +14312,10 @@ export default {
           },
           {
             description:
-              'All access requested for an access grant was successfully granted.',
+              'All access requested for an Access Grant was successfully granted.',
             properties: {
               access_grant_id: {
-                description: 'ID of the affected access grant.',
+                description: 'ID of the affected Access Grant.',
                 format: 'uuid',
                 type: 'string',
               },
@@ -14353,10 +14358,10 @@ export default {
           },
           {
             description:
-              'Access requested as part of an access grant to a particular door was successfully granted.',
+              'Access requested as part of an Access Grant to a particular door was successfully granted.',
             properties: {
               access_grant_id: {
-                description: 'ID of the affected access grant.',
+                description: 'ID of the affected Access Grant.',
                 format: 'uuid',
                 type: 'string',
               },
@@ -14406,10 +14411,10 @@ export default {
           },
           {
             description:
-              'Access to a particular door that was requested as part of an access grant was lost.',
+              'Access to a particular door that was requested as part of an Access Grant was lost.',
             properties: {
               access_grant_id: {
-                description: 'ID of the affected access grant.',
+                description: 'ID of the affected Access Grant.',
                 format: 'uuid',
                 type: 'string',
               },
@@ -14631,7 +14636,7 @@ export default {
           },
           {
             description:
-              'An access method was reissued due to an access grant update.',
+              'An access method was reissued due to an Access Grant update.',
             properties: {
               access_method_id: {
                 description: 'ID of the affected access method.',
@@ -27498,7 +27503,7 @@ export default {
     },
     '/access_grants/create': {
       post: {
-        description: 'Creates a new access grant.',
+        description: 'Creates a new Access Grant.',
         operationId: 'accessGrantsCreatePost',
         requestBody: {
           content: {
@@ -27678,7 +27683,7 @@ export default {
     },
     '/access_grants/delete': {
       delete: {
-        description: 'Delete an access grant.',
+        description: 'Delete an Access Grant.',
         operationId: 'accessGrantsDeleteDelete',
         parameters: [
           {
@@ -27686,7 +27691,7 @@ export default {
             name: 'access_grant_id',
             required: true,
             schema: {
-              description: 'ID of access grant to delete.',
+              description: 'ID of Access Grant to delete.',
               format: 'uuid',
               type: 'string',
             },
@@ -27723,7 +27728,7 @@ export default {
         'x-title': 'Delete an Access Grant',
       },
       post: {
-        description: 'Delete an access grant.',
+        description: 'Delete an Access Grant.',
         operationId: 'accessGrantsDeletePost',
         requestBody: {
           content: {
@@ -27731,7 +27736,7 @@ export default {
               schema: {
                 properties: {
                   access_grant_id: {
-                    description: 'ID of access grant to delete.',
+                    description: 'ID of Access Grant to delete.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -27775,7 +27780,7 @@ export default {
     },
     '/access_grants/get': {
       get: {
-        description: 'Get an access grant.',
+        description: 'Get an Access Grant.',
         operationId: 'accessGrantsGetGet',
         parameters: [
           {
@@ -27783,7 +27788,7 @@ export default {
             name: 'access_grant_id',
             required: true,
             schema: {
-              description: 'ID of access grant to get.',
+              description: 'ID of Access Grant to get.',
               format: 'uuid',
               type: 'string',
             },
@@ -27824,7 +27829,7 @@ export default {
         'x-title': 'Get an Access Grant',
       },
       post: {
-        description: 'Get an access grant.',
+        description: 'Get an Access Grant.',
         operationId: 'accessGrantsGetPost',
         requestBody: {
           content: {
@@ -27832,7 +27837,7 @@ export default {
               schema: {
                 properties: {
                   access_grant_id: {
-                    description: 'ID of access grant to get.',
+                    description: 'ID of Access Grant to get.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -27880,7 +27885,7 @@ export default {
     },
     '/access_grants/list': {
       get: {
-        description: 'Get an access grant.',
+        description: 'Gets an Access Grant.',
         operationId: 'accessGrantsListGet',
         parameters: [
           {
@@ -27888,7 +27893,7 @@ export default {
             name: 'user_identity_id',
             schema: {
               description:
-                '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.',
               format: 'uuid',
               type: 'string',
             },
@@ -27897,7 +27902,8 @@ export default {
             in: 'query',
             name: 'acs_system_id',
             schema: {
-              description: 'ID of system to filter list of access grants by.',
+              description:
+                'ID of the access system by which you want to filter the list of Access Grants.',
               format: 'uuid',
               type: 'string',
             },
@@ -27906,7 +27912,8 @@ export default {
             in: 'query',
             name: 'acs_entrance_id',
             schema: {
-              description: 'ID of entrance to filter list of access grants by.',
+              description:
+                'ID of the entrance by which you want to filter the list of Access Grants.',
               format: 'uuid',
               type: 'string',
             },
@@ -27925,7 +27932,8 @@ export default {
             in: 'query',
             name: 'space_id',
             schema: {
-              description: 'ID of space to filter list of access grants by.',
+              description:
+                'ID of the space by which you want to filter the list of Access Grants.',
               format: 'uuid',
               type: 'string',
             },
@@ -27969,7 +27977,7 @@ export default {
         'x-title': 'List Access Grants',
       },
       post: {
-        description: 'Get an access grant.',
+        description: 'Gets an Access Grant.',
         operationId: 'accessGrantsListPost',
         requestBody: {
           content: {
@@ -27978,13 +27986,13 @@ export default {
                 properties: {
                   acs_entrance_id: {
                     description:
-                      '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.',
                     format: 'uuid',
                     type: 'string',
                   },
                   acs_system_id: {
                     description:
-                      '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.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -27996,13 +28004,13 @@ export default {
                   },
                   space_id: {
                     description:
-                      '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.',
                     format: 'uuid',
                     type: 'string',
                   },
                   user_identity_id: {
                     description:
-                      '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.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -28052,7 +28060,7 @@ export default {
     },
     '/access_grants/update': {
       patch: {
-        description: "Updates an existing access grant's time window.",
+        description: "Updates an existing Access Grant's time window.",
         operationId: 'accessGrantsUpdatePatch',
         requestBody: {
           content: {
@@ -28060,7 +28068,7 @@ export default {
               schema: {
                 properties: {
                   access_grant_id: {
-                    description: 'ID of the access grant to update.',
+                    description: 'ID of the Access Grant to update.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -28116,7 +28124,7 @@ export default {
         'x-title': 'Update an Access Grant',
       },
       post: {
-        description: "Updates an existing access grant's time window.",
+        description: "Updates an existing Access Grant's time window.",
         operationId: 'accessGrantsUpdatePost',
         requestBody: {
           content: {
@@ -28124,7 +28132,7 @@ export default {
               schema: {
                 properties: {
                   access_grant_id: {
-                    description: 'ID of the access grant to update.',
+                    description: 'ID of the Access Grant to update.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -28182,7 +28190,7 @@ export default {
     },
     '/access_methods/delete': {
       delete: {
-        description: 'Delete an access method.',
+        description: 'Deletes an access method.',
         operationId: 'accessMethodsDeleteDelete',
         parameters: [
           {
@@ -28226,7 +28234,7 @@ export default {
         'x-title': 'Delete an Access Method',
       },
       post: {
-        description: 'Delete an access method.',
+        description: 'Deletes an access method.',
         operationId: 'accessMethodsDeletePost',
         requestBody: {
           content: {
@@ -28278,7 +28286,7 @@ export default {
     '/access_methods/encode': {
       post: {
         description:
-          'Encodes an existing [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) onto a plastic card placed on the specified [encoder](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners).',
+          'Encodes an existing access method onto a plastic card placed on the specified [encoder](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners).',
         operationId: 'accessMethodsEncodePost',
         requestBody: {
           content: {
@@ -28293,7 +28301,7 @@ export default {
                   },
                   acs_encoder_id: {
                     description:
-                      'ID of the `acs_encoder` to use to encode the `acs_credential`.',
+                      'ID of the `acs_encoder` to use to encode the `access_method`.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -28342,7 +28350,7 @@ export default {
     },
     '/access_methods/get': {
       get: {
-        description: 'Get an access method.',
+        description: 'Gets an access method.',
         operationId: 'accessMethodsGetGet',
         parameters: [
           {
@@ -28392,7 +28400,7 @@ export default {
         'x-title': 'Get an Access Method',
       },
       post: {
-        description: 'Get an access method.',
+        description: 'Gets an access method.',
         operationId: 'accessMethodsGetPost',
         requestBody: {
           content: {
@@ -28450,7 +28458,7 @@ export default {
     '/access_methods/list': {
       get: {
         description:
-          'List all access methods, usually filtered by access grant.',
+          'Lists all access methods, usually filtered by Access Grant.',
         operationId: 'accessMethodsListGet',
         parameters: [
           {
@@ -28458,7 +28466,7 @@ export default {
             name: 'access_grant_id',
             required: true,
             schema: {
-              description: 'ID of access grant to list access methods for.',
+              description: 'ID of Access Grant to list access methods for.',
               format: 'uuid',
               type: 'string',
             },
@@ -28535,7 +28543,7 @@ export default {
       },
       post: {
         description:
-          'List all access methods, usually filtered by access grant.',
+          'Lists all access methods, usually filtered by Access Grant.',
         operationId: 'accessMethodsListPost',
         requestBody: {
           content: {
@@ -28544,7 +28552,7 @@ export default {
                 properties: {
                   access_grant_id: {
                     description:
-                      'ID of access grant to list access methods for.',
+                      'ID of Access Grant to list access methods for.',
                     format: 'uuid',
                     type: 'string',
                   },
@@ -35999,7 +36007,11 @@ export default {
                       'URL that you want to redirect the user to after the provider login is complete.',
                     type: 'string',
                   },
-                  customer_id: { format: 'uuid', type: 'string' },
+                  customer_key: {
+                    description:
+                      '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.',
+                    type: 'string',
+                  },
                   device_selection_mode: {
                     enum: ['none', 'single', 'multiple'],
                     type: 'string',
@@ -36287,11 +36299,6 @@ export default {
           'Returns a list of all [Connect Webviews](https://docs.seam.co/latest/core-concepts/connect-webviews).',
         operationId: 'connectWebviewsListGet',
         parameters: [
-          {
-            in: 'query',
-            name: 'customer_ids',
-            schema: { items: { type: 'string' }, type: 'array' },
-          },
           {
             in: 'query',
             name: 'user_identifier_key',
@@ -36389,7 +36396,6 @@ export default {
                       '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.',
                     type: 'object',
                   },
-                  customer_ids: { items: { type: 'string' }, type: 'array' },
                   limit: {
                     default: 500,
                     description: