@seamapi/types 1.445.0 → 1.446.0

package/dist/connect.cjs

@@ -3966,6 +3966,7 @@ var space = zod.z.object({
   workspace_id: zod.z.string().uuid().describe(
     "ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) associated with the space."
   ),
+  space_key: zod.z.string().optional().describe("Unique key for the space within the workspace."),
   name: zod.z.string().describe("Name of the space."),
   display_name: zod.z.string().describe("Display name for the space."),
   created_at: zod.z.string().datetime().describe("Date and time at which the space was created."),
@@ -4391,7 +4392,7 @@ var access_code_events = [
   unmanaged_access_code_removed_event
 ];
 var access_grant_event = common_event.extend({
-  access_grant_id: zod.z.string().uuid().describe("ID of the affected access grant.")
+  access_grant_id: zod.z.string().uuid().describe("ID of the affected Access Grant.")
 });
 var access_grant_created_event = access_grant_event.extend({
   event_type: zod.z.literal("access_grant.created")
@@ -4399,7 +4400,7 @@ var access_grant_created_event = access_grant_event.extend({
     ---
     route_path: /access_grants
     ---
-    An access grant was created.
+    An Access Grant was created.
   `);
 var access_grant_deleted_event = access_grant_event.extend({
   event_type: zod.z.literal("access_grant.deleted")
@@ -4407,7 +4408,7 @@ var access_grant_deleted_event = access_grant_event.extend({
     ---
     route_path: /access_grants
     ---
-    An access grant was deleted.
+    An Access Grant was deleted.
   `);
 var access_grant_access_granted_to_all_doors_event = access_grant_event.extend({
   event_type: zod.z.literal("access_grant.access_granted_to_all_doors")
@@ -4415,7 +4416,7 @@ var access_grant_access_granted_to_all_doors_event = access_grant_event.extend({
     ---
     route_path: /access_grants
     ---
-    All access requested for an access grant was successfully granted.
+    All access requested for an Access Grant was successfully granted.
   `);
 var acs_entrance_id = zod.z.string().uuid().describe(
   "ID of the affected [entrance](https://docs.seam.co/latest/capability-guides/retrieving-entrance-details)."
@@ -4427,7 +4428,7 @@ var access_grant_access_granted_to_door_event = access_grant_event.extend({
     ---
     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.
   `);
 var access_grant_access_to_door_lost_event = access_grant_event.extend(
   {
@@ -4438,7 +4439,7 @@ var 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.
   `);
 var access_grant_events = [
   access_grant_created_event,
@@ -4488,7 +4489,7 @@ var 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.
   `);
 var access_method_events = [
   access_method_issued_event,
@@ -7094,34 +7095,38 @@ var openapi_default = {
         "x-route-path": "/access_codes"
       },
       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.",
+        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.",
         properties: {
           access_grant_id: {
-            description: "ID of the access grant.",
+            description: "ID of the Access Grant.",
             format: "uuid",
             type: "string"
           },
+          access_grant_key: {
+            description: "Unique key for the access grant within the workspace.",
+            type: "string"
+          },
           access_method_ids: {
-            description: "IDs of the access methods created for the access grant.",
+            description: "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. ",
+            description: "Instant Key URL. Only returned if the Access Grant has a single mobile_key access_method. ",
             format: "uri",
             type: "string"
           },
@@ -7132,7 +7137,7 @@ var openapi_default = {
             "x-deprecated": "Use `space_ids`."
           },
           requested_access_methods: {
-            description: "Access methods that the user requested for the access grant.",
+            description: "Access methods that the user requested for the Access Grant.",
             items: {
               properties: {
                 created_access_method_ids: {
@@ -7141,7 +7146,7 @@ var openapi_default = {
                   type: "array"
                 },
                 created_at: {
-                  description: "Date and time at which the requested access method was added to the access grant.",
+                  description: "Date and time at which the requested access method was added to the Access Grant.",
                   format: "date-time",
                   type: "string"
                 },
@@ -7166,22 +7171,22 @@ var openapi_default = {
             type: "array"
           },
           space_ids: {
-            description: "IDs of the spaces to which the access grant gives access.",
+            description: "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.",
+            description: "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.",
+            description: "ID of the Seam workspace associated with the Access Grant.",
             format: "uuid",
             type: "string"
           }
@@ -7202,7 +7207,7 @@ var openapi_default = {
         "x-route-path": "/access_grants"
       },
       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.",
+        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.",
         properties: {
           access_method_id: {
             description: "ID of the access method.",
@@ -18173,10 +18178,10 @@ var openapi_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"
               },
@@ -18214,10 +18219,10 @@ var openapi_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"
               },
@@ -18255,10 +18260,10 @@ var openapi_default = {
             "x-route-path": "/access_grants"
           },
           {
-            description: "All access requested for an access grant was successfully granted.",
+            description: "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"
               },
@@ -18299,10 +18304,10 @@ var openapi_default = {
             "x-route-path": "/access_grants"
           },
           {
-            description: "Access requested as part of an access grant to a particular door was successfully granted.",
+            description: "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"
               },
@@ -18349,10 +18354,10 @@ var openapi_default = {
             "x-route-path": "/access_grants"
           },
           {
-            description: "Access to a particular door that was requested as part of an access grant was lost.",
+            description: "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"
               },
@@ -18566,7 +18571,7 @@ var openapi_default = {
             "x-route-path": "/access_methods"
           },
           {
-            description: "An access method was reissued due to an access grant update.",
+            description: "An access method was reissued due to an Access Grant update.",
             properties: {
               access_method_id: {
                 description: "ID of the affected access method.",
@@ -23567,6 +23572,10 @@ var openapi_default = {
             format: "uuid",
             type: "string"
           },
+          space_key: {
+            description: "Unique key for the space within the workspace.",
+            type: "string"
+          },
           workspace_id: {
             description: "ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) associated with the space.",
             format: "uuid",
@@ -30219,7 +30228,7 @@ var openapi_default = {
     },
     "/access_grants/create": {
       post: {
-        description: "Creates a new access grant.",
+        description: "Creates a new Access Grant.",
         operationId: "accessGrantsCreatePost",
         requestBody: {
           content: {
@@ -30271,6 +30280,10 @@ var openapi_default = {
                   },
                   {
                     properties: {
+                      access_grant_key: {
+                        description: "Unique key for the access grant within the workspace.",
+                        type: "string"
+                      },
                       acs_entrance_ids: {
                         default: [],
                         description: "Set of IDs of the [entrances](https://docs.seam.co/latest/api/acs/systems/list) to which access is being granted.",
@@ -30386,7 +30399,7 @@ var openapi_default = {
     },
     "/access_grants/delete": {
       delete: {
-        description: "Delete an access grant.",
+        description: "Delete an Access Grant.",
         operationId: "accessGrantsDeleteDelete",
         parameters: [
           {
@@ -30394,7 +30407,7 @@ var openapi_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"
             }
@@ -30431,7 +30444,7 @@ var openapi_default = {
         "x-title": "Delete an Access Grant"
       },
       post: {
-        description: "Delete an access grant.",
+        description: "Delete an Access Grant.",
         operationId: "accessGrantsDeletePost",
         requestBody: {
           content: {
@@ -30439,7 +30452,7 @@ var openapi_default = {
               schema: {
                 properties: {
                   access_grant_id: {
-                    description: "ID of access grant to delete.",
+                    description: "ID of Access Grant to delete.",
                     format: "uuid",
                     type: "string"
                   }
@@ -30483,20 +30496,8 @@ var openapi_default = {
     },
     "/access_grants/get": {
       get: {
-        description: "Get an access grant.",
+        description: "Get an Access Grant.",
         operationId: "accessGrantsGetGet",
-        parameters: [
-          {
-            in: "query",
-            name: "access_grant_id",
-            required: true,
-            schema: {
-              description: "ID of access grant to get.",
-              format: "uuid",
-              type: "string"
-            }
-          }
-        ],
         responses: {
           200: {
             content: {
@@ -30532,21 +30533,35 @@ var openapi_default = {
         "x-title": "Get an Access Grant"
       },
       post: {
-        description: "Get an access grant.",
+        description: "Get an Access Grant.",
         operationId: "accessGrantsGetPost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
-                properties: {
-                  access_grant_id: {
-                    description: "ID of access grant to get.",
-                    format: "uuid",
-                    type: "string"
+                oneOf: [
+                  {
+                    properties: {
+                      access_grant_id: {
+                        description: "ID of Access Grant to get.",
+                        format: "uuid",
+                        type: "string"
+                      }
+                    },
+                    required: ["access_grant_id"],
+                    type: "object"
+                  },
+                  {
+                    properties: {
+                      access_grant_key: {
+                        description: "Unique key of Access Grant to get.",
+                        type: "string"
+                      }
+                    },
+                    required: ["access_grant_key"],
+                    type: "object"
                   }
-                },
-                required: ["access_grant_id"],
-                type: "object"
+                ]
               }
             }
           }
@@ -30588,14 +30603,14 @@ var openapi_default = {
     },
     "/access_grants/list": {
       get: {
-        description: "Get an access grant.",
+        description: "Gets an Access Grant.",
         operationId: "accessGrantsListGet",
         parameters: [
           {
             in: "query",
             name: "user_identity_id",
             schema: {
-              description: "ID of user identity to filter list of access grants by.",
+              description: "ID of user identity by which you want to filter the list of Access Grants.",
               format: "uuid",
               type: "string"
             }
@@ -30604,7 +30619,7 @@ var openapi_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"
             }
@@ -30613,7 +30628,7 @@ var openapi_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"
             }
@@ -30632,10 +30647,18 @@ var openapi_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"
             }
+          },
+          {
+            in: "query",
+            name: "access_grant_key",
+            schema: {
+              description: "Filter Access Grants by access_grant_key.",
+              type: "string"
+            }
           }
         ],
         responses: {
@@ -30676,20 +30699,24 @@ var openapi_default = {
         "x-title": "List Access Grants"
       },
       post: {
-        description: "Get an access grant.",
+        description: "Gets an Access Grant.",
         operationId: "accessGrantsListPost",
         requestBody: {
           content: {
             "application/json": {
               schema: {
                 properties: {
+                  access_grant_key: {
+                    description: "Filter Access Grants by access_grant_key.",
+                    type: "string"
+                  },
                   acs_entrance_id: {
-                    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"
                   },
                   acs_system_id: {
-                    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"
                   },
@@ -30700,12 +30727,12 @@ var openapi_default = {
                     "x-deprecated": "Use `space_id`."
                   },
                   space_id: {
-                    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"
                   },
                   user_identity_id: {
-                    description: "ID of user identity to filter list of access grants by.",
+                    description: "ID of user identity by which you want to filter the list of Access Grants.",
                     format: "uuid",
                     type: "string"
                   }
@@ -30755,7 +30782,7 @@ var openapi_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: {
@@ -30763,7 +30790,7 @@ var openapi_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"
                   },
@@ -30817,7 +30844,7 @@ var openapi_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: {
@@ -30825,7 +30852,7 @@ var openapi_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"
                   },
@@ -30881,7 +30908,7 @@ var openapi_default = {
     },
     "/access_methods/delete": {
       delete: {
-        description: "Delete an access method.",
+        description: "Deletes an access method.",
         operationId: "accessMethodsDeleteDelete",
         parameters: [
           {
@@ -30925,7 +30952,7 @@ var openapi_default = {
         "x-title": "Delete an Access Method"
       },
       post: {
-        description: "Delete an access method.",
+        description: "Deletes an access method.",
         operationId: "accessMethodsDeletePost",
         requestBody: {
           content: {
@@ -30976,7 +31003,7 @@ var openapi_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).",
+        description: "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: {
@@ -30989,7 +31016,7 @@ var openapi_default = {
                     type: "string"
                   },
                   acs_encoder_id: {
-                    description: "ID of the `acs_encoder` to use to encode the `acs_credential`.",
+                    description: "ID of the `acs_encoder` to use to encode the `access_method`.",
                     format: "uuid",
                     type: "string"
                   }
@@ -31038,7 +31065,7 @@ var openapi_default = {
     },
     "/access_methods/get": {
       get: {
-        description: "Get an access method.",
+        description: "Gets an access method.",
         operationId: "accessMethodsGetGet",
         parameters: [
           {
@@ -31088,7 +31115,7 @@ var openapi_default = {
         "x-title": "Get an Access Method"
       },
       post: {
-        description: "Get an access method.",
+        description: "Gets an access method.",
         operationId: "accessMethodsGetPost",
         requestBody: {
           content: {
@@ -31145,7 +31172,7 @@ var openapi_default = {
     },
     "/access_methods/list": {
       get: {
-        description: "List all access methods, usually filtered by access grant.",
+        description: "Lists all access methods, usually filtered by Access Grant.",
         operationId: "accessMethodsListGet",
         parameters: [
           {
@@ -31153,7 +31180,7 @@ var openapi_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"
             }
@@ -31226,7 +31253,7 @@ var openapi_default = {
         "x-title": "List Access Methods"
       },
       post: {
-        description: "List all access methods, usually filtered by access grant.",
+        description: "Lists all access methods, usually filtered by Access Grant.",
         operationId: "accessMethodsListPost",
         requestBody: {
           content: {
@@ -31234,7 +31261,7 @@ var openapi_default = {
               schema: {
                 properties: {
                   access_grant_id: {
-                    description: "ID of access grant to list access methods for.",
+                    description: "ID of Access Grant to list access methods for.",
                     format: "uuid",
                     type: "string"
                   },
@@ -48722,6 +48749,10 @@ var openapi_default = {
                   name: {
                     description: "Name of the space that you want to create.",
                     type: "string"
+                  },
+                  space_key: {
+                    description: "Unique key for the space within the workspace.",
+                    type: "string"
                   }
                 },
                 required: ["name"],
@@ -48868,18 +48899,6 @@ var openapi_default = {
       get: {
         description: "Gets a space.",
         operationId: "spacesGetGet",
-        parameters: [
-          {
-            in: "query",
-            name: "space_id",
-            required: true,
-            schema: {
-              description: "ID of the space that you want to get.",
-              format: "uuid",
-              type: "string"
-            }
-          }
-        ],
         responses: {
           200: {
             content: {
@@ -48920,15 +48939,29 @@ var openapi_default = {
           content: {
             "application/json": {
               schema: {
-                properties: {
-                  space_id: {
-                    description: "ID of the space that you want to get.",
-                    format: "uuid",
-                    type: "string"
+                oneOf: [
+                  {
+                    properties: {
+                      space_id: {
+                        description: "ID of the space that you want to get.",
+                        format: "uuid",
+                        type: "string"
+                      }
+                    },
+                    required: ["space_id"],
+                    type: "object"
+                  },
+                  {
+                    properties: {
+                      space_key: {
+                        description: "Unique key of the space that you want to get.",
+                        type: "string"
+                      }
+                    },
+                    required: ["space_key"],
+                    type: "object"
                   }
-                },
-                required: ["space_id"],
-                type: "object"
+                ]
               }
             }
           }
@@ -49163,6 +49196,14 @@ var openapi_default = {
               minLength: 1,
               type: "string"
             }
+          },
+          {
+            in: "query",
+            name: "space_key",
+            schema: {
+              description: "Filter spaces by space_key.",
+              type: "string"
+            }
           }
         ],
         responses: {
@@ -49213,6 +49254,10 @@ var openapi_default = {
                     description: "String for which to search. Filters returned spaces to include all records that satisfy a partial match using `name`.",
                     minLength: 1,
                     type: "string"
+                  },
+                  space_key: {
+                    description: "Filter spaces by space_key.",
+                    type: "string"
                   }
                 },
                 type: "object"