@isnap/sdk 1.1.0-next.55 → 1.1.0-next.57

package/dist/generated/openapi.d.ts

@@ -862,152 +862,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/demo/start": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Demo session started */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["DemoStart"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/demo/send-test": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": {
-                        to_number: string;
-                    };
-                };
-            };
-            responses: {
-                /** @description Test message sent */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["DemoSendTest"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/demo/session": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Current demo session */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["DemoSession"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/demo/api-key": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Demo API key generated */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["DemoApiKey"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/analytics/message-volume": {
         parameters: {
             query?: never;
@@ -2692,7 +2546,7 @@ export interface paths {
                 content: {
                     "application/json": {
                         /** @enum {string} */
-                        status: "available" | "ordered" | "shipped" | "received" | "setup_in_progress" | "ready" | "deployed" | "offline" | "decommissioned";
+                        status: "available" | "ordered" | "received" | "setup_in_progress" | "ready" | "deployed" | "offline" | "decommissioned";
                     };
                 };
             };
@@ -2761,7 +2615,7 @@ export interface paths {
         get: {
             parameters: {
                 query?: {
-                    billing_tier?: "rental_iphone" | "rental_android" | "byod_imessage" | "byod_android" | "shared_pool";
+                    billing_tier?: "rental_iphone" | "rental_android" | "byod_imessage" | "byod_android" | "shared_pool" | "shared_imessage";
                     status?: string;
                     assigned?: boolean | null;
                     fulfillment?: "pending" | "fulfilled";
@@ -2803,7 +2657,7 @@ export interface paths {
                 query?: {
                     page?: number;
                     limit?: number;
-                    billing_tier?: "rental_iphone" | "rental_android" | "byod_imessage" | "byod_android" | "shared_pool";
+                    billing_tier?: "rental_iphone" | "rental_android" | "byod_imessage" | "byod_android" | "shared_pool" | "shared_imessage";
                 };
                 header?: never;
                 path?: never;
@@ -2924,14 +2778,16 @@ export interface paths {
         };
         get: {
             parameters: {
-                query?: never;
+                query?: {
+                    purpose?: "trial" | "shared";
+                };
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Pool fleet summary + per-line trial/usage metrics */
+                /** @description Pool fleet summary + per-line trial/binding/quota metrics + per-scope virtual/physical overcommit */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -2973,6 +2829,82 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/admin/lines/shared": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["AdminMintSharedLineBody"];
+                };
+            };
+            responses: {
+                /** @description Virtual shared line minted for the target customer */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Line"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/admin/pool-lines/{id}/demote": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Pool line demoted to a rental line (blocked while live trials or active bindings exist) */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["DemotePoolLine"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/admin/activation-codes/{code}/status": {
         parameters: {
             query?: never;
@@ -3490,7 +3422,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/va/devices": {
+    "/va/performance": {
         parameters: {
             query?: never;
             header?: never;
@@ -3499,71 +3431,68 @@ export interface paths {
         };
         get: {
             parameters: {
-                query?: {
-                    page?: number;
-                    limit?: number;
-                    type?: "iphone" | "android";
-                    status?: string;
-                    availableForEsim?: boolean | null;
-                };
+                query?: never;
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Device inventory */
+                /** @description VA performance KPIs */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["VADeviceInventory"];
+                        "application/json": components["schemas"]["VAPerformance"];
                     };
                 };
             };
         };
         put?: never;
-        post: {
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/va/mac-minis": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: {
             parameters: {
                 query?: never;
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
-            requestBody?: {
-                content: {
-                    "application/json": {
-                        model: string;
-                        /** @enum {string} */
-                        type: "iphone" | "android";
-                        imei?: string;
-                        purchaseDate?: string;
-                        /** Format: uuid */
-                        farmId: string;
-                        notes?: string;
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Device created */
+                /** @description Fleet Mac Minis with session counts */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["VADevice"];
+                        "application/json": components["schemas"]["VAMacMinis"];
                     };
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/va/esims": {
+    "/va/mac-minis/next": {
         parameters: {
             query?: never;
             header?: never;
@@ -3572,11 +3501,249 @@ export interface paths {
         };
         get: {
             parameters: {
-                query?: {
-                    page?: number;
-                    limit?: number;
-                    areaCode?: string;
-                    status?: string;
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Preview the least-loaded Mac Mini (no commit) */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["VANextMacMini"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/va/macos-sessions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        appleAccountId: string;
+                        login: string;
+                        password: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description macOS session created (or pending_provisioning) */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["VAMacosSession"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/va/devices": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: {
+            parameters: {
+                query?: {
+                    page?: number;
+                    limit?: number;
+                    type?: "iphone" | "android";
+                    status?: string;
+                    availableForEsim?: boolean | null;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Device inventory */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["VADeviceInventory"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        model: string;
+                        /** @enum {string} */
+                        type: "iphone" | "android";
+                        imei?: string;
+                        purchaseDate?: string;
+                        /** Format: uuid */
+                        farmId: string;
+                        notes?: string;
+                        unitCostCents?: number;
+                    };
+                };
+            };
+            responses: {
+                /** @description Device created */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["VADevice"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/va/devices/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        model?: string;
+                        imei?: string | null;
+                        notes?: string;
+                        unitCostCents?: number | null;
+                        /** Format: uuid */
+                        farmId?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Device updated */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["VADevice"];
+                    };
+                };
+            };
+        };
+        trace?: never;
+    };
+    "/va/device-models": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: {
+            parameters: {
+                query?: {
+                    platform?: "iphone" | "android";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description VA-readable device-model catalogue */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["VADeviceModels"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/va/esims": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: {
+            parameters: {
+                query?: {
+                    page?: number;
+                    limit?: number;
+                    areaCode?: string;
+                    status?: string;
                 };
                 header?: never;
                 path?: never;
@@ -3723,7 +3890,7 @@ export interface paths {
                 query?: {
                     page?: number;
                     limit?: number;
-                    type?: "buy_device" | "buy_esim" | "create_apple_account" | "assemble_line" | "ship_device";
+                    type?: "buy_device" | "buy_esim" | "create_apple_account" | "assemble_line";
                     status?: string;
                 };
                 header?: never;
@@ -3755,7 +3922,7 @@ export interface paths {
                 content: {
                     "application/json": {
                         /** @enum {string} */
-                        type: "buy_device" | "buy_esim" | "create_apple_account" | "assemble_line" | "ship_device";
+                        type: "buy_device" | "buy_esim" | "create_apple_account" | "assemble_line";
                         /** @default 3 */
                         priority?: number;
                         dueAt?: string;
@@ -3877,54 +4044,42 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/va/devices/{id}/ship": {
+    "/va/farms": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
-        post: {
+        get: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    id: string;
-                };
+                path?: never;
                 cookie?: never;
             };
-            requestBody?: {
-                content: {
-                    "application/json": {
-                        trackingNumber?: string;
-                        carrier?: string;
-                        trackingUrl?: string;
-                        expectedArrivalDate?: string;
-                        notes?: string;
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Device shipped */
+                /** @description Farms list */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["VADevice"];
+                        "application/json": components["schemas"]["FarmsList"];
                     };
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/va/farms": {
+    "/va/carriers": {
         parameters: {
             query?: never;
             header?: never;
@@ -3940,13 +4095,13 @@ export interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Farms list */
+                /** @description Carriers */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["FarmsList"];
+                        "application/json": components["schemas"]["Carriers"];
                     };
                 };
             };
@@ -3959,7 +4114,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/va/carriers": {
+    "/va/carrier-plans/{carrierName}": {
         parameters: {
             query?: never;
             header?: never;
@@ -3970,18 +4125,20 @@ export interface paths {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
+                path: {
+                    carrierName: string;
+                };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Carriers */
+                /** @description Carrier plans */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["Carriers"];
+                        "application/json": components["schemas"]["CarrierPlans"];
                     };
                 };
             };
@@ -3994,44 +4151,42 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/va/carrier-plans/{carrierName}": {
+    "/va/generate-email": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get: {
+        get?: never;
+        put?: never;
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    carrierName: string;
-                };
+                path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Carrier plans */
+                /** @description Stalwart email generated */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["CarrierPlans"];
+                        "application/json": components["schemas"]["StalwartEmail"];
                     };
                 };
             };
         };
-        put?: never;
-        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/va/generate-email": {
+    "/va/fetch-activation-code": {
         parameters: {
             query?: never;
             header?: never;
@@ -4047,34 +4202,142 @@ export interface paths {
                 path?: never;
                 cookie?: never;
             };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /** Format: email */
+                        email: string;
+                        password: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description eSIM activation code */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["EsimActivationCode"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/va/esim-email/{preOrderId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    preOrderId: string;
+                };
+                cookie?: never;
+            };
             requestBody?: never;
             responses: {
-                /** @description Stalwart email generated */
+                /** @description eSIM email for pre-order */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["StalwartEmail"];
+                        "application/json": components["schemas"]["EsimEmail"];
                     };
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/va/fetch-activation-code": {
+    "/v1/api-keys": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
+        /**
+         * List API keys
+         * @description Return every non-revoked API key for the authenticated user. Includes the key prefix, scope, line allowlist, and last-used timestamp — never the plaintext (which is only emitted once at create time).
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description API key list */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ApiKeyList"];
+                    };
+                };
+                /** @description Bad request — validation failed */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Unauthenticated — missing or invalid bearer token */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Too many requests — rate limit exceeded */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+            };
+        };
         put?: never;
+        /**
+         * Create an API key
+         * @description Mint a new API key for the authenticated user. The plaintext key is returned ONCE in this response — store it; the server only keeps a hash. Optional `line_ids` array scopes the key to specific lines; omit or pass `[]` for account-wide access.
+         */
         post: {
             parameters: {
                 query?: never;
@@ -4085,20 +4348,60 @@ export interface paths {
             requestBody?: {
                 content: {
                     "application/json": {
-                        /** Format: email */
-                        email: string;
-                        password: string;
+                        name?: string;
+                        /**
+                         * @default live
+                         * @enum {string}
+                         */
+                        scope?: "test" | "live";
+                        line_ids?: string[];
                     };
                 };
             };
             responses: {
-                /** @description eSIM activation code */
-                200: {
+                /** @description API key created */
+                201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["EsimActivationCode"];
+                        "application/json": components["schemas"]["ApiKeyCreate"];
+                    };
+                };
+                /** @description Bad request — validation failed */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Unauthenticated — missing or invalid bearer token */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Too many requests — rate limit exceeded */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
                     };
                 };
             };
@@ -4109,31 +4412,172 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/va/esim-email/{preOrderId}": {
+    "/v1/api-keys/{id}": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get: {
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Revoke an API key
+         * @description Mark the API key as revoked. Subsequent requests presenting this key receive 401. Revocation is irreversible — issue a fresh key via `POST /v1/api-keys` to regain access.
+         */
+        delete: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
-                    preOrderId: string;
+                    id: string;
                 };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description eSIM email for pre-order */
+                /** @description API key revoked */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["EsimEmail"];
+                        "application/json": components["schemas"]["ApiKeyRevoke"];
+                    };
+                };
+                /** @description Bad request — validation failed */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Unauthenticated — missing or invalid bearer token */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Forbidden — caller authenticated but not allowed */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Too many requests — rate limit exceeded */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/lines": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List available lines (public marketplace)
+         * @description Browse the marketplace inventory of unassigned lines. Filter by billing tier, area code, country code, status. Returns only `status: available` and never the iSnap-internal `shared_pool` tier. Unauthenticated — partners use this in prospecting / quote flows.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    billing_tier?: "rental_iphone" | "rental_android" | "byod_imessage" | "byod_android" | "shared_pool" | "shared_imessage";
+                    area_code?: string;
+                    country_code?: string;
+                    /** @description US state filter — 2-letter code or full name. */
+                    state?: string;
+                    /** @description Country filter — ISO alpha-2 code or country name. */
+                    country?: string;
+                    status?: string;
+                    page?: number;
+                    limit?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Available lines */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {boolean} */
+                            success: true;
+                            data: components["schemas"]["LineList"];
+                            trace_id: string;
+                            request_id: string;
+                        };
+                    };
+                };
+                /** @description Bad request — validation failed */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Too many requests — rate limit exceeded */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
                     };
                 };
             };
@@ -4146,7 +4590,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/api-keys": {
+    "/v1/lines/my": {
         parameters: {
             query?: never;
             header?: never;
@@ -4154,8 +4598,8 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * List API keys
-         * @description Return every non-revoked API key for the authenticated user. Includes the key prefix, scope, line allowlist, and last-used timestamp — never the plaintext (which is only emitted once at create time).
+         * List the caller's own lines
+         * @description Return every line owned by the authenticated user that's in `active` or `reserved` status. Includes a `fulfillment_status` hint for lines whose hardware is still being procured. Accepts an API key (`isnap_*`) or a dashboard JWT.
          */
         get: {
             parameters: {
@@ -4166,13 +4610,19 @@ export interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description API key list */
+                /** @description User lines */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ApiKeyList"];
+                        "application/json": {
+                            /** @enum {boolean} */
+                            success: true;
+                            data: components["schemas"]["MyLines"];
+                            trace_id: string;
+                            request_id: string;
+                        };
                     };
                 };
                 /** @description Bad request — validation failed */
@@ -4214,38 +4664,48 @@ export interface paths {
             };
         };
         put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/lines/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
         /**
-         * Create an API key
-         * @description Mint a new API key for the authenticated user. The plaintext key is returned ONCE in this response — store it; the server only keeps a hash. Optional `line_ids` array scopes the key to specific lines; omit or pass `[]` for account-wide access.
+         * Get line details (public marketplace)
+         * @description Fetch a single line by its `line_<base62>` id. Available unauthenticated for the marketplace browsing flow; partner-private metadata still requires API key access via `GET /v1/lines/my`.
          */
-        post: {
+        get: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": {
-                        name?: string;
-                        /**
-                         * @default live
-                         * @enum {string}
-                         */
-                        scope?: "test" | "live";
-                        line_ids?: string[];
-                    };
+                path: {
+                    id: string;
                 };
+                cookie?: never;
             };
+            requestBody?: never;
             responses: {
-                /** @description API key created */
-                201: {
+                /** @description Line */
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ApiKeyCreate"];
+                        "application/json": {
+                            /** @enum {boolean} */
+                            success: true;
+                            data: components["schemas"]["Line"];
+                            trace_id: string;
+                            request_id: string;
+                        };
                     };
                 };
                 /** @description Bad request — validation failed */
@@ -4257,8 +4717,8 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorEnvelope"];
                     };
                 };
-                /** @description Unauthenticated — missing or invalid bearer token */
-                401: {
+                /** @description Not found */
+                404: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -4286,27 +4746,16 @@ export interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/api-keys/{id}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        post?: never;
         /**
-         * Revoke an API key
-         * @description Mark the API key as revoked. Subsequent requests presenting this key receive 401. Revocation is irreversible — issue a fresh key via `POST /v1/api-keys` to regain access.
+         * Update line metadata
+         * @description Merge-patch the line's free-form `metadata` tag object. Pass `null` for a key to delete it; pass a new value to overwrite. Metadata is echoed on every `line.*` webhook so partners can attribute events back to their own customer IDs.
          */
-        delete: {
+        patch: {
             parameters: {
                 query?: never;
                 header?: never;
@@ -4315,15 +4764,25 @@ export interface paths {
                 };
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["PatchLine"];
+                };
+            };
             responses: {
-                /** @description API key revoked */
+                /** @description Line with merged metadata */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ApiKeyRevoke"];
+                        "application/json": {
+                            /** @enum {boolean} */
+                            success: true;
+                            data: components["schemas"]["Line"];
+                            trace_id: string;
+                            request_id: string;
+                        };
                     };
                 };
                 /** @description Bad request — validation failed */
@@ -4382,43 +4841,35 @@ export interface paths {
                 };
             };
         };
-        options?: never;
-        head?: never;
-        patch?: never;
         trace?: never;
     };
-    "/v1/lines": {
+    "/v1/lines/assign": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * List available lines (public marketplace)
-         * @description Browse the marketplace inventory of unassigned lines. Filter by billing tier, area code, country code, status. Returns only `status: available` and never the iSnap-internal `shared_pool` tier. Unauthenticated — partners use this in prospecting / quote flows.
+         * Atomically reserve + activate a line
+         * @description Find an available line matching `billing_tier` (and optional `area_code`), reserve it, and activate it in a single round-trip. Useful when the partner doesn't care which specific number they get — saves the reserve→checkout→activate dance. Scoped API keys are rejected (cannot assign lines outside their allowlist).
          */
-        get: {
+        post: {
             parameters: {
-                query?: {
-                    billing_tier?: "rental_iphone" | "rental_android" | "byod_imessage" | "byod_android" | "shared_pool";
-                    area_code?: string;
-                    country_code?: string;
-                    /** @description US state filter — 2-letter code or full name. */
-                    state?: string;
-                    /** @description Country filter — ISO alpha-2 code or country name. */
-                    country?: string;
-                    status?: string;
-                    page?: number;
-                    limit?: number;
-                };
+                query?: never;
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["AssignLine"];
+                };
+            };
             responses: {
-                /** @description Available lines */
+                /** @description Line assigned and activated */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -4427,7 +4878,7 @@ export interface paths {
                         "application/json": {
                             /** @enum {boolean} */
                             success: true;
-                            data: components["schemas"]["LineList"];
+                            data: components["schemas"]["Line"];
                             trace_id: string;
                             request_id: string;
                         };
@@ -4442,8 +4893,8 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorEnvelope"];
                     };
                 };
-                /** @description Too many requests — rate limit exceeded */
-                429: {
+                /** @description Unauthenticated — missing or invalid bearer token */
+                401: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -4451,8 +4902,8 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorEnvelope"];
                     };
                 };
-                /** @description Internal server error */
-                500: {
+                /** @description Forbidden — caller authenticated but not allowed */
+                403: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -4460,53 +4911,8 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorEnvelope"];
                     };
                 };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/lines/my": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * List the caller's own lines
-         * @description Return every line owned by the authenticated user that's in `active` or `reserved` status. Includes a `fulfillment_status` hint for lines whose hardware is still being procured. Accepts an API key (`isnap_*`) or a dashboard JWT.
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description User lines */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @enum {boolean} */
-                            success: true;
-                            data: components["schemas"]["MyLines"];
-                            trace_id: string;
-                            request_id: string;
-                        };
-                    };
-                };
-                /** @description Bad request — validation failed */
-                400: {
+                /** @description Not found */
+                404: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -4514,8 +4920,8 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorEnvelope"];
                     };
                 };
-                /** @description Unauthenticated — missing or invalid bearer token */
-                401: {
+                /** @description Conflict — concurrent or terminal state */
+                409: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -4543,38 +4949,40 @@ export interface paths {
                 };
             };
         };
-        put?: never;
-        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/lines/{id}": {
+    "/v1/lines/shared": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * Get line details (public marketplace)
-         * @description Fetch a single line by its `line_<base62>` id. Available unauthenticated for the marketplace browsing flow; partner-private metadata still requires API key access via `GET /v1/lines/my`.
+         * Mint a virtual shared-outbound line
+         * @description Mint a customer-owned VIRTUAL line on the shared-outbound plan (billing_tier `shared_imessage`): no dedicated hardware, no phone number of its own — sends are proxied onto the shared physical iMessage fleet, with a per-contact physical number resolved at send time. Minted directly `active` with no per-line Stripe subscription (wholesale is metered end-of-month on the active virtual-line count). Wholesale-partner only in v1; direct-customer callers get 402 until self-serve checkout ships (an admin can provision one for them in the meantime). Optional `metadata` is persisted and echoed on `line.*` webhooks. Supports `Idempotency-Key` — every mint creates a fresh billable line, so retries MUST carry the same key to avoid double-minting.
          */
-        get: {
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    id: string;
-                };
+                path?: never;
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["MintSharedLine"];
+                };
+            };
             responses: {
-                /** @description Line */
-                200: {
+                /** @description Virtual shared line minted */
+                201: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -4597,8 +5005,35 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorEnvelope"];
                     };
                 };
-                /** @description Not found */
-                404: {
+                /** @description Unauthenticated — missing or invalid bearer token */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Payment required — no billing relationship entitles this call */
+                402: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Forbidden — caller authenticated but not allowed */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Conflict — concurrent or terminal state */
+                409: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -4626,16 +5061,26 @@ export interface paths {
                 };
             };
         };
-        put?: never;
-        post?: never;
         delete?: never;
         options?: never;
         head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/lines/{id}/reserve": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
         /**
-         * Update line metadata
-         * @description Merge-patch the line's free-form `metadata` tag object. Pass `null` for a key to delete it; pass a new value to overwrite. Metadata is echoed on every `line.*` webhook so partners can attribute events back to their own customer IDs.
+         * Reserve an available line
+         * @description Move a specific line from `available` to `reserved` for 15 minutes. After that window a background worker auto-releases the reservation. Call `POST /v1/billing/checkout` next to convert the reservation into an active subscription.
          */
-        patch: {
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
@@ -4644,13 +5089,9 @@ export interface paths {
                 };
                 cookie?: never;
             };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["PatchLine"];
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Line with merged metadata */
+                /** @description Line reserved */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -4701,6 +5142,15 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorEnvelope"];
                     };
                 };
+                /** @description Conflict — concurrent or terminal state */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
                 /** @description Too many requests — rate limit exceeded */
                 429: {
                     headers: {
@@ -4721,9 +5171,13 @@ export interface paths {
                 };
             };
         };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
         trace?: never;
     };
-    "/v1/lines/assign": {
+    "/v1/lines/{id}/activate": {
         parameters: {
             query?: never;
             header?: never;
@@ -4733,23 +5187,25 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Atomically reserve + activate a line
-         * @description Find an available line matching `billing_tier` (and optional `area_code`), reserve it, and activate it in a single round-trip. Useful when the partner doesn't care which specific number they get — saves the reserve→checkout→activate dance. Scoped API keys are rejected (cannot assign lines outside their allowlist).
+         * Activate a reserved line
+         * @description Commit a `reserved` line to `active`. Wholesale partners (no Stripe checkout surface) use this as the second phase of reserve→activate — they reserve, bill their own end-user, then activate within the 15-minute window with no per-line Stripe sub (EOM-metered), and may pick the inbound-only rental variant via `inbound_only`. Direct callers get the test/dev mock-sub shortcut (production direct activation happens via the Stripe webhook on `checkout.session.completed`); `inbound_only` is ignored for them (theirs comes from the checkout price).
          */
         post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
+                path: {
+                    id: string;
+                };
                 cookie?: never;
             };
             requestBody?: {
                 content: {
-                    "application/json": components["schemas"]["AssignLine"];
+                    "application/json": components["schemas"]["ActivateLine"];
                 };
             };
             responses: {
-                /** @description Line assigned and activated */
+                /** @description Line activated */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -4835,7 +5291,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/lines/{id}/reserve": {
+    "/v1/lines/{id}/transfer-ownership": {
         parameters: {
             query?: never;
             header?: never;
@@ -4845,8 +5301,8 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Reserve an available line
-         * @description Move a specific line from `available` to `reserved` for 15 minutes. After that window a background worker auto-releases the reservation. Call `POST /v1/billing/checkout` next to convert the reservation into an active subscription.
+         * Transfer a line to another iSnap user
+         * @description Move ownership of a line to a different iSnap user. By default the paired device session stays attached so messaging continues uninterrupted; pass `preserve_device_session: false` to force the new owner to re-pair. See `/concepts/billing` for how the cutover handles the in-flight Stripe subscription.
          */
         post: {
             parameters: {
@@ -4857,9 +5313,13 @@ export interface paths {
                 };
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["TransferOwnership"];
+                };
+            };
             responses: {
-                /** @description Line reserved */
+                /** @description Ownership transferred */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -4945,7 +5405,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/lines/{id}/activate": {
+    "/v1/lines/{id}/convert-to-test": {
         parameters: {
             query?: never;
             header?: never;
@@ -4955,8 +5415,8 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Activate a reserved line
-         * @description Commit a `reserved` line to `active`. Wholesale partners (no Stripe checkout surface) use this as the second phase of reserve→activate — they reserve, bill their own end-user, then activate within the 15-minute window with no per-line Stripe sub (EOM-metered), and may pick the inbound-only rental variant via `inbound_only`. Direct callers get the test/dev mock-sub shortcut (production direct activation happens via the Stripe webhook on `checkout.session.completed`); `inbound_only` is ignored for them (theirs comes from the checkout price).
+         * Convert an owned rental line into a test line
+         * @description Flip a rental line you own into an owned test line that backs trials in your own pool (ownership → pool; the monthly price stays the rental-equivalent, not the $0 global-pool rate). Rejected on byod lines, lines you do not own, and lines carrying an active subscription.
          */
         post: {
             parameters: {
@@ -4967,13 +5427,9 @@ export interface paths {
                 };
                 cookie?: never;
             };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["ActivateLine"];
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Line activated */
+                /** @description Line converted to a test line */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5059,7 +5515,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/lines/{id}/transfer-ownership": {
+    "/v1/lines/{id}/convert-from-test": {
         parameters: {
             query?: never;
             header?: never;
@@ -5069,8 +5525,8 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Transfer a line to another iSnap user
-         * @description Move ownership of a line to a different iSnap user. By default the paired device session stays attached so messaging continues uninterrupted; pass `preserve_device_session: false` to force the new owner to re-pair. See `/concepts/billing` for how the cutover handles the in-flight Stripe subscription.
+         * Revert an owned test line back to a rental line
+         * @description Symmetric to convert-to-test: flip an owned test line back to a rental line (ownership → rental, rental price re-stamped). Rejected while the test line still hosts live trials, since reverting would strand them.
          */
         post: {
             parameters: {
@@ -5081,13 +5537,9 @@ export interface paths {
                 };
                 cookie?: never;
             };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["TransferOwnership"];
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Ownership transferred */
+                /** @description Line reverted to a rental line */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -8321,28 +8773,194 @@ export interface paths {
          */
         get: {
             parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Attachment record + fresh signed download URL */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {boolean} */
+                            success: true;
+                            data: components["schemas"]["Attachment"];
+                            trace_id: string;
+                            request_id: string;
+                        };
+                    };
+                };
+                /** @description Bad request — validation failed */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Unauthenticated — missing or invalid bearer token */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Too many requests — rate limit exceeded */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/lookup": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Look up a recipient capability
+         * @description Check whether a phone number or email is iMessage-capable. Returns `imessage: true | false | null`; `null` means we have no cached probe result yet and the caller should fall back to SMS-safe behaviour. Rate-limited per line and per account.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["LookupRequest"];
+                };
+            };
+            responses: {
+                /** @description Lookup result */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["LookupEnvelope"];
+                    };
+                };
+                /** @description Bad request — validation failed */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Unauthenticated — missing or invalid bearer token */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Too many requests — rate limit exceeded */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/area-codes": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List selectable area codes (public)
+         * @description Enumerate the area codes a customer can request as `preferred_area_codes` on `POST /v1/pre-orders`, for rendering a pre-order area-code picker. Optional `?country=US` filters the list. Also returns the selectable countries so the same response can drive a country dropdown. Unauthenticated — mirrors `GET /v1/lines` and `GET /pricing`. The list is the *selectable* set (a curated subset of NANP), not a guarantee of immediate inventory: pre-orders are precisely for tiers with no in-stock line.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description ISO 3166-1 alpha-2 country filter (case-insensitive). Omit for all countries. */
+                    country?: string;
                 };
+                header?: never;
+                path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Attachment record + fresh signed download URL */
+                /** @description Selectable area codes + countries */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": {
-                            /** @enum {boolean} */
-                            success: true;
-                            data: components["schemas"]["Attachment"];
-                            trace_id: string;
-                            request_id: string;
-                        };
+                        "application/json": components["schemas"]["AreaCodesEnvelope"];
                     };
                 };
                 /** @description Bad request — validation failed */
@@ -8354,24 +8972,6 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorEnvelope"];
                     };
                 };
-                /** @description Unauthenticated — missing or invalid bearer token */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorEnvelope"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorEnvelope"];
-                    };
-                };
                 /** @description Too many requests — rate limit exceeded */
                 429: {
                     headers: {
@@ -8400,39 +9000,39 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/lookup": {
+    "/v1/chats": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
         /**
-         * Look up a recipient capability
-         * @description Check whether a phone number or email is iMessage-capable. Returns `imessage: true | false | null`; `null` means we have no cached probe result yet and the caller should fall back to SMS-safe behaviour. Rate-limited per line and per account.
+         * List chats
+         * @description Cursor-paginated list of the caller's conversations, newest activity first. Filter by `line_id`. On shared-plan (virtual) lines each chat carries `outbound_number` — the physical number currently serving that contact (null once the binding is released; the next outbound is assigned a fresh number). Non-shared lines always carry `outbound_number: null`. Accepts an API key (`isnap_*`) or a dashboard JWT; line-scoped API keys only see chats of the lines in their allowlist.
          */
-        post: {
+        get: {
             parameters: {
-                query?: never;
+                query?: {
+                    line_id?: string;
+                    limit?: number;
+                    cursor?: string;
+                    since?: string;
+                    until?: string;
+                };
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["LookupRequest"];
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Lookup result */
+                /** @description Chat list */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["LookupEnvelope"];
+                        "application/json": components["schemas"]["ChatListEnvelope"];
                     };
                 };
                 /** @description Bad request — validation failed */
@@ -8473,13 +9073,15 @@ export interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/area-codes": {
+    "/v1/chats/{chat_id}": {
         parameters: {
             query?: never;
             header?: never;
@@ -8487,28 +9089,27 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * List selectable area codes (public)
-         * @description Enumerate the area codes a customer can request as `preferred_area_codes` on `POST /v1/pre-orders`, for rendering a pre-order area-code picker. Optional `?country=US` filters the list. Also returns the selectable countries so the same response can drive a country dropdown. Unauthenticated — mirrors `GET /v1/lines` and `GET /pricing`. The list is the *selectable* set (a curated subset of NANP), not a guarantee of immediate inventory: pre-orders are precisely for tiers with no in-stock line.
+         * Get a chat
+         * @description Fetch a single conversation by its `chat_<base62>` id. Same shape as the list items, including `outbound_number` for shared-plan lines. Cross-account and out-of-scope ids resolve 404 (no existence leak).
          */
         get: {
             parameters: {
-                query?: {
-                    /** @description ISO 3166-1 alpha-2 country filter (case-insensitive). Omit for all countries. */
-                    country?: string;
-                };
+                query?: never;
                 header?: never;
-                path?: never;
+                path: {
+                    chat_id: string;
+                };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Selectable area codes + countries */
+                /** @description Chat */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["AreaCodesEnvelope"];
+                        "application/json": components["schemas"]["ChatEnvelope"];
                     };
                 };
                 /** @description Bad request — validation failed */
@@ -8520,6 +9121,24 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorEnvelope"];
                     };
                 };
+                /** @description Unauthenticated — missing or invalid bearer token */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
                 /** @description Too many requests — rate limit exceeded */
                 429: {
                     headers: {
@@ -8946,7 +9565,7 @@ export interface paths {
         put?: never;
         /**
          * Start a trial session
-         * @description Create a pairing-pending trial session against the caller's API key. Returns a one-time pairing token the partner embeds in their onboarding UI; the recipient claims it by sending an inbound message that links them to a shared-pool line.
+         * @description Create a pairing-pending trial session owned by the caller (dashboard JWT for direct self-serve, or an API key for wholesale/SDK). Returns a one-time pairing token the partner embeds in their onboarding UI; the recipient claims it by sending an inbound message that links them to a pool line. Direct accounts may hold only one live trial at a time.
          */
         post: {
             parameters: {
@@ -8988,6 +9607,15 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorEnvelope"];
                     };
                 };
+                /** @description Conflict — concurrent or terminal state */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
                 /** @description Too many requests — rate limit exceeded */
                 429: {
                     headers: {
@@ -10197,45 +10825,6 @@ export interface components {
         LineWatchList: {
             watches: components["schemas"]["LineWatch"][];
         };
-        DemoStart: {
-            /** Format: uuid */
-            session_id: string;
-            line: {
-                /** Format: uuid */
-                id: string;
-                phone_number: string;
-                billing_tier: string;
-            };
-            api_key: string | null;
-        };
-        DemoSendTest: {
-            success: boolean;
-            /** Format: uuid */
-            message_id: string;
-        };
-        DemoSession: {
-            /** Format: uuid */
-            session_id: string;
-            line: {
-                /** Format: uuid */
-                id: string;
-                phone_number: string;
-                billing_tier: string;
-            };
-            messages_sent: number;
-            daily_limit: number;
-            test_number: string | null;
-            completed: boolean;
-            expires_at: string | null;
-            created_at: string;
-            has_api_key: boolean;
-        };
-        DemoApiKey: {
-            key: string;
-            /** Format: uuid */
-            id: string;
-            prefix: string;
-        };
         MessageVolume: {
             dates: string[];
             counts: number[];
@@ -10676,6 +11265,10 @@ export interface components {
             /** @enum {string} */
             ownership: "pool";
             /** @enum {string} */
+            pool_purpose: "trial" | "shared";
+            /** Format: uuid */
+            owner_user_id: string | null;
+            /** @enum {string} */
             platform: "imessage";
             status: string;
             monthly_price: number;
@@ -10688,10 +11281,53 @@ export interface components {
         CreatePoolLineBody: {
             /** Format: uuid */
             line_id?: string;
+            /**
+             * @default trial
+             * @enum {string}
+             */
+            purpose: "trial" | "shared";
+            /** Format: uuid */
+            owner_user_id?: string;
             phone_number?: string;
             area_code?: string;
             country_code?: string;
         };
+        Line: {
+            id: string;
+            phone_number: string;
+            area_code: string | null;
+            country_code: string | null;
+            state: string | null;
+            state_name: string | null;
+            /** @enum {string} */
+            billing_tier: "rental_iphone" | "rental_android" | "byod_imessage" | "byod_android" | "shared_pool" | "shared_imessage";
+            /** @description True when the customer owns the underlying hardware (BYOD billing tiers). BYOD lines expose the full line-health surface (offline/degraded events, GET /v1/lines/{id}/health). Rental lines (false) only emit durable, actionable events to keep customers out of transient infrastructure noise they cannot act on. */
+            byod: boolean;
+            /** @description True when the line is inbound-only: it may only message a handle that has messaged it first (a recipient who has never contacted the line is rejected with 403 outbound_first_forbidden). Inbound-only is a cheaper rental-tier variant (Bloo parity); always false on BYOD/pool lines. */
+            inbound_only: boolean;
+            capabilities?: unknown;
+            status: string;
+            monthly_price: number;
+            stripe_subscription_id: string | null;
+            activated_at: string | null;
+            expires_at: string | null;
+            created_at: string;
+            metadata: {
+                [key: string]: unknown;
+            } | null;
+            /** @description True when the line is an owner-provisioned test line (ownership=pool with a set owner) that backs the owner's own trial pool. Its monthly_price is the rental-equivalent, not the $0 global pool rate. */
+            test_line: boolean;
+            /** @description True when the line is a virtual shared-plan line (billing_tier shared_imessage): customer-owned, no dedicated hardware, phone_number empty — sends are proxied onto the shared physical iMessage fleet. Line-scoped API keys, webhooks and per-line quota apply to it like any other line. */
+            shared: boolean;
+            fulfillment_status?: string | null;
+        };
+        AdminMintSharedLineBody: {
+            metadata?: {
+                [key: string]: unknown;
+            };
+            /** Format: uuid */
+            user_id: string;
+        };
         PoolLinesMonitor: {
             summary: {
                 total_lines: number;
@@ -10700,14 +11336,20 @@ export interface components {
                 active_trials: number;
                 dormant_trials: number;
                 pairing_pending_trials: number;
+                active_bindings: number;
             };
             lines: components["schemas"]["PoolLineMonitorItem"][];
+            overcommit: components["schemas"]["PoolOvercommitScope"][];
         };
         PoolLineMonitorItem: {
             /** Format: uuid */
             id: string;
             public_id: string;
             phone_number: string | null;
+            /** @enum {string} */
+            purpose: "trial" | "shared";
+            /** Format: uuid */
+            owner_user_id: string | null;
             status: string;
             health_state: string;
             /** Format: uuid */
@@ -10716,9 +11358,36 @@ export interface components {
             active_trials: number;
             dormant_trials: number;
             pairing_pending_trials: number;
+            active_bindings: number;
+            daily_new_used: number;
+            daily_new_limit: number;
+            daily_new_headroom: number;
+            last_activity_at: string | null;
             messages_24h: number;
             created_at: string;
         };
+        PoolOvercommitScope: {
+            /** @enum {string} */
+            scope: "global" | "partner";
+            /** Format: uuid */
+            owner_user_id: string | null;
+            active_virtual_lines: number;
+            physical_lines: number;
+            ratio: number | null;
+        };
+        DemotePoolLine: {
+            /** Format: uuid */
+            id: string;
+            public_id: string;
+            /** @enum {string} */
+            ownership: "rental";
+            pool_purpose: unknown;
+            status: string;
+            monthly_price: number;
+            /** Format: uuid */
+            owner_user_id: string | null;
+            updated_at: string;
+        };
         ActivationCodeStatus: {
             consumed: boolean;
             consumedAt: string | null;
@@ -10867,9 +11536,6 @@ export interface components {
                 devices: {
                     available: number;
                     ordered: number;
-                    shipped: number;
-                    received: number;
-                    ready: number;
                     total: number;
                 };
                 esims: {
@@ -10886,6 +11552,51 @@ export interface components {
             pendingAssembly: number;
             pendingTasks: number;
         };
+        VAPerformance: {
+            throughput: {
+                today: number;
+                week: number;
+                total: number;
+            };
+            speed: {
+                avgCompletionMins: number;
+                onTimeRate: number;
+            };
+            backlog: {
+                open: number;
+                overdue: number;
+            };
+        };
+        VAMacMinis: {
+            macMinis: components["schemas"]["VAMacMini"][];
+        };
+        VAMacMini: {
+            /** Format: uuid */
+            id: string;
+            name: string;
+            hostname: string | null;
+            status: string;
+            capacity: number;
+            sessionCount: number;
+        };
+        VANextMacMini: {
+            /** Format: uuid */
+            macMiniId: string | null;
+            hostname: string | null;
+            /** @enum {string} */
+            status: "available" | "pending_provisioning";
+        };
+        VAMacosSession: {
+            /** Format: uuid */
+            sessionId: string;
+            /** Format: uuid */
+            macMiniId: string;
+            macMiniName: string;
+            macMiniHostname: string | null;
+            /** @enum {string} */
+            status: "created" | "pending_provisioning";
+            ordered: boolean;
+        };
         VADevice: {
             /** Format: uuid */
             id: string;
@@ -10896,6 +11607,8 @@ export interface components {
             /** Format: uuid */
             farmId: string | null;
             farmName: string | null;
+            unitCostCents?: number | null;
+            invoiceUrl?: string | null;
             createdAt: string;
             taskCompleted?: boolean;
         };
@@ -10903,6 +11616,15 @@ export interface components {
             devices: components["schemas"]["VADevice"][];
             total: number;
         };
+        VADeviceModels: {
+            models: {
+                /** Format: uuid */
+                id: string;
+                name: string;
+                /** @enum {string} */
+                platform: "iphone" | "android";
+            }[];
+        };
         VAEsim: {
             /** Format: uuid */
             id: string;
@@ -10943,6 +11665,8 @@ export interface components {
             /** Format: uuid */
             assigneeId: string | null;
             /** Format: uuid */
+            completedBy: string | null;
+            /** Format: uuid */
             deviceId: string | null;
             /** Format: uuid */
             esimId: string | null;
@@ -11038,31 +11762,6 @@ export interface components {
             page: number;
             limit: number;
         };
-        Line: {
-            id: string;
-            phone_number: string;
-            area_code: string | null;
-            country_code: string | null;
-            state: string | null;
-            state_name: string | null;
-            /** @enum {string} */
-            billing_tier: "rental_iphone" | "rental_android" | "byod_imessage" | "byod_android" | "shared_pool";
-            /** @description True when the customer owns the underlying hardware (BYOD billing tiers). BYOD lines expose the full line-health surface (offline/degraded events, GET /v1/lines/{id}/health). Rental lines (false) only emit durable, actionable events to keep customers out of transient infrastructure noise they cannot act on. */
-            byod: boolean;
-            /** @description True when the line is inbound-only: it may only message a handle that has messaged it first (a recipient who has never contacted the line is rejected with 403 outbound_first_forbidden). Inbound-only is a cheaper rental-tier variant (Bloo parity); always false on BYOD/pool lines. */
-            inbound_only: boolean;
-            capabilities?: unknown;
-            status: string;
-            monthly_price: number;
-            stripe_subscription_id: string | null;
-            activated_at: string | null;
-            expires_at: string | null;
-            created_at: string;
-            metadata: {
-                [key: string]: unknown;
-            } | null;
-            fulfillment_status?: string | null;
-        };
         MyLines: {
             lines: components["schemas"]["Line"][];
         };
@@ -11071,6 +11770,12 @@ export interface components {
             billing_tier: "rental_iphone" | "rental_android" | "byod_imessage" | "byod_android";
             area_code?: string;
             inbound_only?: boolean;
+            as_test_line?: boolean;
+            metadata?: {
+                [key: string]: unknown;
+            };
+        };
+        MintSharedLine: {
             metadata?: {
                 [key: string]: unknown;
             };
@@ -11489,7 +12194,7 @@ export interface components {
          * @description A concrete event type (e.g. `message.received`), a family wildcard (`line.*`), or the catch-all `*`.
          * @enum {string}
          */
-        WebhookEventName: "message.queued" | "message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.received" | "message.scheduled" | "message.cancelled" | "message.fallback_triggered" | "reaction.added" | "reaction.received" | "reaction.removed" | "line.connected" | "line.disconnected" | "line.offline" | "line.degraded" | "line.apple_id_flagged" | "line.quota_warning" | "line.quota_exceeded" | "line.capability_changed" | "typing_indicator.started" | "typing_indicator.stopped" | "trial.linked" | "trial.dormant" | "trial.reactivated" | "pre_order.fulfilled" | "pre_order.cancelled" | "pre_order.refunded" | "webhook.test" | "*" | "message.*" | "reaction.*" | "line.*" | "typing_indicator.*" | "trial.*" | "webhook.*";
+        WebhookEventName: "message.queued" | "message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.received" | "message.scheduled" | "message.cancelled" | "message.fallback_triggered" | "reaction.added" | "reaction.received" | "reaction.removed" | "line.connected" | "line.disconnected" | "line.offline" | "line.degraded" | "line.apple_id_flagged" | "line.quota_warning" | "line.quota_exceeded" | "line.capability_changed" | "typing_indicator.started" | "typing_indicator.stopped" | "trial.linked" | "trial.dormant" | "trial.reactivated" | "trial.bind_conflict" | "binding.released" | "pre_order.fulfilled" | "pre_order.cancelled" | "pre_order.refunded" | "webhook.test" | "*" | "message.*" | "reaction.*" | "line.*" | "typing_indicator.*" | "trial.*" | "binding.*" | "webhook.*";
         WebhookList: {
             webhooks: components["schemas"]["Webhook"][];
         };
@@ -11662,6 +12367,38 @@ export interface components {
             /** @example 1 */
             calling_code: string;
         };
+        ChatListEnvelope: {
+            /** @enum {boolean} */
+            success: true;
+            data: components["schemas"]["ChatList"];
+            trace_id: string;
+            request_id: string;
+        };
+        ChatList: {
+            items: components["schemas"]["Chat"][];
+            has_more: boolean;
+            next_cursor: string | null;
+        };
+        Chat: {
+            /** @example chat_5h7FqK2mNpQ8rT3vW9xY1zA4b */
+            id: string;
+            line_id: string;
+            contact_handle: string;
+            /** @description Shared-plan lines only: the physical number currently serving this contact (the active binding). Null when no binding is active — e.g. after inactivity release, in which case the next outbound is assigned a fresh number — and always null on non-shared lines. */
+            outbound_number: string | null;
+            last_message_at: string;
+            message_count: number;
+            unread_count: number;
+            created_at: string;
+            updated_at: string;
+        };
+        ChatEnvelope: {
+            /** @enum {boolean} */
+            success: true;
+            data: components["schemas"]["Chat"];
+            trace_id: string;
+            request_id: string;
+        };
         ShareContactCardEnvelope: {
             /** @enum {boolean} */
             success: true;