@seamapi/types 1.589.0 → 1.591.0

package/dist/connect.d.cts

@@ -10373,6 +10373,8 @@ declare const batch: z.ZodObject<{
         created_at: z.ZodString;
         device_count: z.ZodNumber;
         acs_entrance_count: z.ZodNumber;
+        parent_space_id: z.ZodOptional<z.ZodString>;
+        parent_space_key: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         display_name: string;
@@ -10382,6 +10384,8 @@ declare const batch: z.ZodObject<{
         space_id: string;
         acs_entrance_count: number;
         space_key?: string | undefined;
+        parent_space_id?: string | undefined;
+        parent_space_key?: string | undefined;
     }, {
         name: string;
         display_name: string;
@@ -10391,6 +10395,8 @@ declare const batch: z.ZodObject<{
         space_id: string;
         acs_entrance_count: number;
         space_key?: string | undefined;
+        parent_space_id?: string | undefined;
+        parent_space_key?: string | undefined;
     }>, "many">>;
     devices: z.ZodOptional<z.ZodArray<z.ZodObject<{
         device_id: z.ZodString;
@@ -30889,6 +30895,8 @@ declare const batch: z.ZodObject<{
         space_id: string;
         acs_entrance_count: number;
         space_key?: string | undefined;
+        parent_space_id?: string | undefined;
+        parent_space_key?: string | undefined;
     }[] | undefined;
     devices?: {
         display_name: string;
@@ -34786,6 +34794,8 @@ declare const batch: z.ZodObject<{
         space_id: string;
         acs_entrance_count: number;
         space_key?: string | undefined;
+        parent_space_id?: string | undefined;
+        parent_space_key?: string | undefined;
     }[] | undefined;
     devices?: {
         display_name: string;
@@ -50852,6 +50862,8 @@ declare const space: z.ZodObject<{
     created_at: z.ZodString;
     device_count: z.ZodNumber;
     acs_entrance_count: z.ZodNumber;
+    parent_space_id: z.ZodOptional<z.ZodString>;
+    parent_space_key: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     display_name: string;
@@ -50861,6 +50873,8 @@ declare const space: z.ZodObject<{
     space_id: string;
     acs_entrance_count: number;
     space_key?: string | undefined;
+    parent_space_id?: string | undefined;
+    parent_space_key?: string | undefined;
 }, {
     name: string;
     display_name: string;
@@ -50870,6 +50884,8 @@ declare const space: z.ZodObject<{
     space_id: string;
     acs_entrance_count: number;
     space_key?: string | undefined;
+    parent_space_id?: string | undefined;
+    parent_space_key?: string | undefined;
 }>;
 type Space = z.infer<typeof space>;
 
@@ -63469,6 +63485,15 @@ declare const _default: {
                         description: string;
                         type: string;
                     };
+                    parent_space_id: {
+                        format: string;
+                        type: string;
+                        'x-undocumented': string;
+                    };
+                    parent_space_key: {
+                        type: string;
+                        'x-undocumented': string;
+                    };
                     space_id: {
                         description: string;
                         format: string;
@@ -82365,6 +82390,105 @@ declare const _default: {
             };
         };
         '/connected_accounts/update': {
+            patch: {
+                description: string;
+                operationId: string;
+                requestBody: {
+                    content: {
+                        'application/json': {
+                            schema: {
+                                properties: {
+                                    accepted_capabilities: {
+                                        description: string;
+                                        items: {
+                                            description: string;
+                                            enum: string[];
+                                            type: string;
+                                        };
+                                        type: string;
+                                    };
+                                    automatically_manage_new_devices: {
+                                        description: string;
+                                        type: string;
+                                    };
+                                    connected_account_id: {
+                                        description: string;
+                                        format: string;
+                                        type: string;
+                                    };
+                                    custom_metadata: {
+                                        additionalProperties: {
+                                            nullable: boolean;
+                                            oneOf: ({
+                                                maxLength: number;
+                                                type: string;
+                                            } | {
+                                                type: string;
+                                                maxLength?: never;
+                                            })[];
+                                        };
+                                        description: string;
+                                        type: string;
+                                    };
+                                    customer_key: {
+                                        description: string;
+                                        minLength: number;
+                                        type: string;
+                                    };
+                                };
+                                required: string[];
+                                type: string;
+                            };
+                        };
+                    };
+                };
+                responses: {
+                    200: {
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    properties: {
+                                        connected_account: {
+                                            $ref: string;
+                                        };
+                                        ok: {
+                                            type: string;
+                                        };
+                                    };
+                                    required: string[];
+                                    type: string;
+                                };
+                            };
+                        };
+                        description: string;
+                    };
+                    400: {
+                        description: string;
+                    };
+                    401: {
+                        description: string;
+                    };
+                };
+                security: ({
+                    pat_with_workspace: never[];
+                    console_session_with_workspace?: never;
+                    api_key?: never;
+                } | {
+                    console_session_with_workspace: never[];
+                    pat_with_workspace?: never;
+                    api_key?: never;
+                } | {
+                    api_key: never[];
+                    pat_with_workspace?: never;
+                    console_session_with_workspace?: never;
+                })[];
+                summary: string;
+                tags: string[];
+                'x-fern-sdk-group-name': string[];
+                'x-fern-sdk-method-name': string;
+                'x-response-key': null;
+                'x-title': string;
+            };
             post: {
                 description: string;
                 operationId: string;
@@ -94687,6 +94811,94 @@ declare const _default: {
                 'x-undocumented': string;
             };
         };
+        '/seam/customer/v1/spaces/create': {
+            post: {
+                description: string;
+                operationId: string;
+                requestBody: {
+                    content: {
+                        'application/json': {
+                            schema: {
+                                properties: {
+                                    acs_entrance_ids: {
+                                        description: string;
+                                        items: {
+                                            format: string;
+                                            type: string;
+                                        };
+                                        type: string;
+                                    };
+                                    device_ids: {
+                                        description: string;
+                                        items: {
+                                            format: string;
+                                            type: string;
+                                        };
+                                        type: string;
+                                    };
+                                    name: {
+                                        description: string;
+                                        type: string;
+                                    };
+                                    parent_space_key: {
+                                        description: string;
+                                        type: string;
+                                    };
+                                    parent_space_name: {
+                                        description: string;
+                                        type: string;
+                                    };
+                                    space_key: {
+                                        description: string;
+                                        type: string;
+                                    };
+                                };
+                                required: string[];
+                                type: string;
+                            };
+                        };
+                    };
+                };
+                responses: {
+                    200: {
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    properties: {
+                                        ok: {
+                                            type: string;
+                                        };
+                                        space: {
+                                            $ref: string;
+                                        };
+                                    };
+                                    required: string[];
+                                    type: string;
+                                };
+                            };
+                        };
+                        description: string;
+                    };
+                    400: {
+                        description: string;
+                    };
+                    401: {
+                        description: string;
+                    };
+                };
+                security: {
+                    client_session_with_customer: never[];
+                }[];
+                summary: string;
+                tags: never[];
+                'x-draft': string;
+                'x-fern-sdk-group-name': string[];
+                'x-fern-sdk-method-name': string;
+                'x-fern-sdk-return-value': string;
+                'x-response-key': string;
+                'x-title': string;
+            };
+        };
         '/seam/instant_key/v1/client_sessions/exchange_short_code': {
             post: {
                 description: string;
@@ -116889,6 +117101,10 @@ type Routes = {
                     device_count: number;
                     /** Number of entrances in the space. */
                     acs_entrance_count: number;
+                    /**  */
+                    parent_space_id?: string | undefined;
+                    /**  */
+                    parent_space_key?: string | undefined;
                 }[] | undefined;
                 devices?: {
                     /** ID of the device. */
@@ -120200,6 +120416,10 @@ type Routes = {
                     device_count: number;
                     /** Number of entrances in the space. */
                     acs_entrance_count: number;
+                    /**  */
+                    parent_space_id?: string | undefined;
+                    /**  */
+                    parent_space_key?: string | undefined;
                 }[] | undefined;
                 devices?: {
                     /** ID of the device. */
@@ -137410,7 +137630,7 @@ type 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;
-            /** 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. */
+            /** Associate the Connect Webview, the connected account, and all resources under the connected account with a customer. If the connected account already exists, it will be associated with the customer. If the connected account already exists, but is already associated with a customer, the Connect Webview will show an error. */
             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?: ('hotek' | 'dormakaba_community' | 'legic_connect' | 'akuvox' | 'august' | 'avigilon_alta' | 'brivo' | 'butterflymx' | 'schlage' | 'smartthings' | 'yale' | 'genie' | 'doorking' | 'salto' | 'salto_ks' | 'lockly' | 'ttlock' | 'linear' | 'noiseaware' | 'nuki' | 'seam_relay_admin' | 'igloo' | 'kwikset' | 'minut' | 'my_2n' | 'controlbyweb' | 'nest' | 'igloohome' | 'ecobee' | 'hubitat' | 'four_suites' | 'dormakaba_oracode' | 'pti' | 'wyze' | 'seam_passport' | 'visionline' | 'assa_abloy_credential_service' | 'tedee' | 'honeywell_resideo' | 'latch' | 'akiles' | 'assa_abloy_vostio' | 'assa_abloy_vostio_credential_service' | 'tado' | 'salto_space' | 'sensi' | 'kwikset2' | 'keynest' | 'dormakaba_ambiance' | 'yale_access' | 'hid_cm' | 'google_nest')[] | undefined;
@@ -137985,7 +138205,7 @@ type Routes = {
     };
     '/connected_accounts/update': {
         route: '/connected_accounts/update';
-        method: 'POST';
+        method: 'PATCH' | 'POST';
         queryParams: {};
         jsonBody: {
             /** ID of the connected account that you want to update. */
@@ -137998,7 +138218,7 @@ type Routes = {
             } | undefined;
             /** List of accepted device capabilities that restrict the types of devices that can be connected through this connected account. Valid values are `lock`, `thermostat`, `noise_sensor`, and `access_control`. */
             accepted_capabilities?: ('lock' | 'thermostat' | 'noise_sensor' | 'access_control')[] | undefined;
-            /** The customer key to associate with this connected account. If provided, the connected account and all resources under the connected account will be moved to this customer.  */
+            /** The customer key to associate with this connected account. If provided, the connected account and all resources under the connected account will be moved to this customer. May only be provided if the connected account is not already associated with a customer. */
             customer_key?: string | undefined;
         };
         commonParams: {};
@@ -165396,6 +165616,52 @@ type Routes = {
         formData: {};
         jsonResponse: {};
     };
+    '/seam/customer/v1/spaces/create': {
+        route: '/seam/customer/v1/spaces/create';
+        method: 'POST';
+        queryParams: {};
+        jsonBody: {
+            /** Name of the space that you want to create. */
+            name: string;
+            /** Unique key for the space within the workspace. */
+            space_key?: string | undefined;
+            /** IDs of the devices that you want to add to the new space. */
+            device_ids?: string[] | undefined;
+            /** IDs of the entrances that you want to add to the new space. */
+            acs_entrance_ids?: string[] | undefined;
+            /** Space key of the parent space for this space. */
+            parent_space_key?: string | undefined;
+            /** Name of the parent space for this space. */
+            parent_space_name?: string | undefined;
+        };
+        commonParams: {};
+        formData: {};
+        jsonResponse: {
+            /** Represents a space that is a logical grouping of devices and entrances. You can assign access to an entire space, thereby making granting access more efficient. */
+            space: {
+                /** ID of the space. */
+                space_id: string;
+                /** ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) associated with the space. */
+                workspace_id: string;
+                /** Unique key for the space within the workspace. */
+                space_key?: string | undefined;
+                /** Name of the space. */
+                name: string;
+                /** Display name for the space. */
+                display_name: string;
+                /** Date and time at which the space was created. */
+                created_at: string;
+                /** Number of devices in the space. */
+                device_count: number;
+                /** Number of entrances in the space. */
+                acs_entrance_count: number;
+                /**  */
+                parent_space_id?: string | undefined;
+                /**  */
+                parent_space_key?: string | undefined;
+            };
+        };
+    };
     '/seam/instant_key/v1/client_sessions/exchange_short_code': {
         route: '/seam/instant_key/v1/client_sessions/exchange_short_code';
         method: 'POST';
@@ -166069,6 +166335,10 @@ type Routes = {
                 device_count: number;
                 /** Number of entrances in the space. */
                 acs_entrance_count: number;
+                /**  */
+                parent_space_id?: string | undefined;
+                /**  */
+                parent_space_key?: string | undefined;
             };
         };
     };
@@ -166116,6 +166386,10 @@ type Routes = {
                 device_count: number;
                 /** Number of entrances in the space. */
                 acs_entrance_count: number;
+                /**  */
+                parent_space_id?: string | undefined;
+                /**  */
+                parent_space_key?: string | undefined;
             };
         };
     };
@@ -166154,6 +166428,10 @@ type Routes = {
                     device_count: number;
                     /** Number of entrances in the space. */
                     acs_entrance_count: number;
+                    /**  */
+                    parent_space_id?: string | undefined;
+                    /**  */
+                    parent_space_key?: string | undefined;
                 }[] | undefined;
                 devices?: {
                     /** ID of the device. */
@@ -167761,6 +168039,10 @@ type Routes = {
                 device_count: number;
                 /** Number of entrances in the space. */
                 acs_entrance_count: number;
+                /**  */
+                parent_space_id?: string | undefined;
+                /**  */
+                parent_space_key?: string | undefined;
             }[];
         };
     };
@@ -167831,6 +168113,10 @@ type Routes = {
                 device_count: number;
                 /** Number of entrances in the space. */
                 acs_entrance_count: number;
+                /**  */
+                parent_space_id?: string | undefined;
+                /**  */
+                parent_space_key?: string | undefined;
             };
         };
     };
@@ -187198,6 +187484,10 @@ type Routes = {
                     device_count: number;
                     /** Number of entrances in the space. */
                     acs_entrance_count: number;
+                    /**  */
+                    parent_space_id?: string | undefined;
+                    /**  */
+                    parent_space_key?: string | undefined;
                 }[] | undefined;
                 devices?: {
                     /** ID of the device. */

package/dist/index.cjs

@@ -5347,7 +5347,17 @@ var space = zod.z.object({
   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."),
   device_count: zod.z.number().describe("Number of devices in the space."),
-  acs_entrance_count: zod.z.number().describe("Number of entrances in the space.")
+  acs_entrance_count: zod.z.number().describe("Number of entrances in the space."),
+  parent_space_id: zod.z.string().uuid().optional().describe(`
+    ---
+    undocumented: Only used internally.
+    ---
+    `),
+  parent_space_key: zod.z.string().optional().describe(`
+    ---
+    undocumented: Only used internally.
+    ---
+    `)
 }).describe(`
   ---
   draft: Early access.
@@ -24415,6 +24425,15 @@ var openapi_default = {
             type: "string"
           },
           name: { description: "Name of the space.", type: "string" },
+          parent_space_id: {
+            format: "uuid",
+            type: "string",
+            "x-undocumented": "Only used internally."
+          },
+          parent_space_key: {
+            type: "string",
+            "x-undocumented": "Only used internally."
+          },
           space_id: {
             description: "ID of the space.",
             format: "uuid",
@@ -41497,7 +41516,7 @@ var openapi_default = {
                     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.",
+                    description: "Associate the Connect Webview, the connected account, and all resources under the connected account with a customer. If the connected account already exists, it will be associated with the customer. If the connected account already exists, but is already associated with a customer, the Connect Webview will show an error.",
                     type: "string"
                   },
                   device_selection_mode: {
@@ -42402,6 +42421,93 @@ var openapi_default = {
       }
     },
     "/connected_accounts/update": {
+      patch: {
+        description: "Updates a [connected account](https://docs.seam.co/latest/core-concepts/connected-accounts).",
+        operationId: "connectedAccountsUpdatePatch",
+        requestBody: {
+          content: {
+            "application/json": {
+              schema: {
+                properties: {
+                  accepted_capabilities: {
+                    description: "List of accepted device capabilities that restrict the types of devices that can be connected through this connected account. Valid values are `lock`, `thermostat`, `noise_sensor`, and `access_control`.",
+                    items: {
+                      description: "\n  High-level device capabilities that can be restricted in connect webviews.\n  These represent the main device categories that customers can opt into.\n",
+                      enum: [
+                        "lock",
+                        "thermostat",
+                        "noise_sensor",
+                        "access_control"
+                      ],
+                      type: "string"
+                    },
+                    type: "array"
+                  },
+                  automatically_manage_new_devices: {
+                    description: "Indicates whether newly-added devices should appear as [managed devices](https://docs.seam.co/latest/core-concepts/devices/managed-and-unmanaged-devices).",
+                    type: "boolean"
+                  },
+                  connected_account_id: {
+                    description: "ID of the connected account that you want to update.",
+                    format: "uuid",
+                    type: "string"
+                  },
+                  custom_metadata: {
+                    additionalProperties: {
+                      nullable: true,
+                      oneOf: [
+                        { maxLength: 500, type: "string" },
+                        { type: "boolean" }
+                      ]
+                    },
+                    description: "Custom metadata that you want to associate with the connected account. Entirely replaces the existing custom metadata object. If a new Connect Webview contains custom metadata and is used to reconnect a connected account, the custom metadata from the Connect Webview will entirely replace the entire custom metadata object on the connected account. Supports up to 50 JSON key:value pairs. [Adding custom metadata to a connected account](https://docs.seam.co/latest/core-concepts/connected-accounts/adding-custom-metadata-to-a-connected-account) enables you to store custom information, like customer details or internal IDs from your application. Then, you can [filter connected accounts by the desired metadata](https://docs.seam.co/latest/core-concepts/connected-accounts/filtering-connected-accounts-by-custom-metadata).",
+                    type: "object"
+                  },
+                  customer_key: {
+                    description: "The customer key to associate with this connected account. If provided, the connected account and all resources under the connected account will be moved to this customer. May only be provided if the connected account is not already associated with a customer.",
+                    minLength: 1,
+                    type: "string"
+                  }
+                },
+                required: ["connected_account_id"],
+                type: "object"
+              }
+            }
+          }
+        },
+        responses: {
+          200: {
+            content: {
+              "application/json": {
+                schema: {
+                  properties: {
+                    connected_account: {
+                      $ref: "#/components/schemas/connected_account"
+                    },
+                    ok: { type: "boolean" }
+                  },
+                  required: ["connected_account", "ok"],
+                  type: "object"
+                }
+              }
+            },
+            description: "OK"
+          },
+          400: { description: "Bad Request" },
+          401: { description: "Unauthorized" }
+        },
+        security: [
+          { pat_with_workspace: [] },
+          { console_session_with_workspace: [] },
+          { api_key: [] }
+        ],
+        summary: "/connected_accounts/update",
+        tags: ["/connected_accounts"],
+        "x-fern-sdk-group-name": ["connected_accounts"],
+        "x-fern-sdk-method-name": "update",
+        "x-response-key": null,
+        "x-title": "Update a Connected Account"
+      },
       post: {
         description: "Updates a [connected account](https://docs.seam.co/latest/core-concepts/connected-accounts).",
         operationId: "connectedAccountsUpdatePost",
@@ -42445,7 +42551,7 @@ var openapi_default = {
                     type: "object"
                   },
                   customer_key: {
-                    description: "The customer key to associate with this connected account. If provided, the connected account and all resources under the connected account will be moved to this customer. ",
+                    description: "The customer key to associate with this connected account. If provided, the connected account and all resources under the connected account will be moved to this customer. May only be provided if the connected account is not already associated with a customer.",
                     minLength: 1,
                     type: "string"
                   }
@@ -54293,6 +54399,78 @@ var openapi_default = {
         "x-undocumented": "Internal endpoint for customer portals."
       }
     },
+    "/seam/customer/v1/spaces/create": {
+      post: {
+        description: "Creates a new space with optional parent space support.",
+        operationId: "seamCustomerV1SpacesCreatePost",
+        requestBody: {
+          content: {
+            "application/json": {
+              schema: {
+                properties: {
+                  acs_entrance_ids: {
+                    description: "IDs of the entrances that you want to add to the new space.",
+                    items: { format: "uuid", type: "string" },
+                    type: "array"
+                  },
+                  device_ids: {
+                    description: "IDs of the devices that you want to add to the new space.",
+                    items: { format: "uuid", type: "string" },
+                    type: "array"
+                  },
+                  name: {
+                    description: "Name of the space that you want to create.",
+                    type: "string"
+                  },
+                  parent_space_key: {
+                    description: "Space key of the parent space for this space.",
+                    type: "string"
+                  },
+                  parent_space_name: {
+                    description: "Name of the parent space for this space.",
+                    type: "string"
+                  },
+                  space_key: {
+                    description: "Unique key for the space within the workspace.",
+                    type: "string"
+                  }
+                },
+                required: ["name"],
+                type: "object"
+              }
+            }
+          }
+        },
+        responses: {
+          200: {
+            content: {
+              "application/json": {
+                schema: {
+                  properties: {
+                    ok: { type: "boolean" },
+                    space: { $ref: "#/components/schemas/space" }
+                  },
+                  required: ["space", "ok"],
+                  type: "object"
+                }
+              }
+            },
+            description: "OK"
+          },
+          400: { description: "Bad Request" },
+          401: { description: "Unauthorized" }
+        },
+        security: [{ client_session_with_customer: [] }],
+        summary: "/seam/customer/v1/spaces/create",
+        tags: [],
+        "x-draft": "Early access.",
+        "x-fern-sdk-group-name": ["seam", "customer", "v1", "spaces"],
+        "x-fern-sdk-method-name": "create",
+        "x-fern-sdk-return-value": "space",
+        "x-response-key": "space",
+        "x-title": "Create a Space"
+      }
+    },
     "/seam/instant_key/v1/client_sessions/exchange_short_code": {
       post: {
         description: "Exchanges a short code for a client session token. Mobile apps use this endpoint to retrieve a client session token securely using a short code obtained from an Instant Key URL.",