@samsarahq/samsara 13.20.0 → 13.22.0

package/dist/cjs/BaseClient.js

@@ -44,8 +44,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@samsarahq/samsara",
-        "X-Fern-SDK-Version": "13.20.0",
-        "User-Agent": "@samsarahq/samsara/13.20.0",
+        "X-Fern-SDK-Version": "13.22.0",
+        "User-Agent": "@samsarahq/samsara/13.22.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
         "X-Samsara-Version": (_a = options === null || options === void 0 ? void 0 : options.version) !== null && _a !== void 0 ? _a : "2025-06-11",

package/dist/cjs/api/resources/betaApIs/client/Client.d.ts

@@ -1142,6 +1142,39 @@ export declare class BetaApIsClient {
      */
     getFunctionRun(request: Samsara.GetFunctionRunRequest, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.FunctionsGetFunctionRunResponseBody>;
     private __getFunctionRun;
+    /**
+     * Reassign one or more gateways to different devices in a single call. Mirrors the dashboard's "Pair Gateway" flow and accepts up to 50 gateway-device pairs per request. Works for any device type: vehicles, assets, equipment, trailers, industrial machines, and asset tags. By default, devices that the reassigned gateways were previously linked to remain in their current group. Pass `removeOrphanDevices: true` to move those orphaned devices to the unassigned group and clear their tags. The endpoint is currently in Beta and gated behind a feature configuration; contact your Samsara representative to enable access.
+     *
+     *  <b>Rate limit:</b> 100 requests/min (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+     *
+     * To use this endpoint, select **Write Gateways** under the Setup & Administration category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+     *
+     *
+     *  **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+     *
+     * @param {Samsara.GatewaysPairGatewaysRequestBody} request
+     * @param {BetaApIsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Samsara.UnauthorizedError}
+     * @throws {@link Samsara.NotFoundError}
+     * @throws {@link Samsara.MethodNotAllowedError}
+     * @throws {@link Samsara.TooManyRequestsError}
+     * @throws {@link Samsara.InternalServerError}
+     * @throws {@link Samsara.NotImplementedError}
+     * @throws {@link Samsara.BadGatewayError}
+     * @throws {@link Samsara.ServiceUnavailableError}
+     * @throws {@link Samsara.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.betaApIs.pairGateways({
+     *         pairs: [{
+     *                 deviceSerial: "GFRV-43N-VGX",
+     *                 gatewaySerial: "GFRV-43N-VGX"
+     *             }]
+     *     })
+     */
+    pairGateways(request: Samsara.GatewaysPairGatewaysRequestBody, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.GatewaysPairGatewaysResponseBody>;
+    private __pairGateways;
     /**
      * Update the shippingDocs field of an existing assignment.
      *
@@ -1298,6 +1331,62 @@ export declare class BetaApIsClient {
      */
     deleteHubRouteTemplate(request: Samsara.DeleteHubRouteTemplateRequest, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<void>;
     private __deleteHubRouteTemplate;
+    /**
+     * Returns a paginated list of preventive maintenance schedules for the organization.
+     *
+     *  <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+     *
+     * To use this endpoint, select **Read Preventive Maintenance Schedules** under the Preventive Maintenance category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+     *
+     *
+     *  **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+     *
+     * @param {Samsara.ListPreventiveMaintenanceSchedulesRequest} request
+     * @param {BetaApIsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Samsara.UnauthorizedError}
+     * @throws {@link Samsara.NotFoundError}
+     * @throws {@link Samsara.MethodNotAllowedError}
+     * @throws {@link Samsara.TooManyRequestsError}
+     * @throws {@link Samsara.InternalServerError}
+     * @throws {@link Samsara.NotImplementedError}
+     * @throws {@link Samsara.BadGatewayError}
+     * @throws {@link Samsara.ServiceUnavailableError}
+     * @throws {@link Samsara.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.betaApIs.listPreventiveMaintenanceSchedules()
+     */
+    listPreventiveMaintenanceSchedules(request?: Samsara.ListPreventiveMaintenanceSchedulesRequest, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.EntityPreventativeMaintenanceSchedulesServiceListPreventiveMaintenanceSchedulesResponseBody>;
+    private __listPreventiveMaintenanceSchedules;
+    /**
+     * Returns a paginated list of upcoming preventive maintenance schedules for the organization's assets, enriched with live telemetry (current odometer, engine hours) and due-date projections.
+     *
+     *  <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+     *
+     * To use this endpoint, select **Read Upcoming Preventive Maintenance** under the Preventive Maintenance category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+     *
+     *
+     *  **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+     *
+     * @param {Samsara.ListUpcomingPreventiveMaintenanceRequest} request
+     * @param {BetaApIsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Samsara.UnauthorizedError}
+     * @throws {@link Samsara.NotFoundError}
+     * @throws {@link Samsara.MethodNotAllowedError}
+     * @throws {@link Samsara.TooManyRequestsError}
+     * @throws {@link Samsara.InternalServerError}
+     * @throws {@link Samsara.NotImplementedError}
+     * @throws {@link Samsara.BadGatewayError}
+     * @throws {@link Samsara.ServiceUnavailableError}
+     * @throws {@link Samsara.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.betaApIs.listUpcomingPreventiveMaintenance()
+     */
+    listUpcomingPreventiveMaintenance(request?: Samsara.ListUpcomingPreventiveMaintenanceRequest, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.EntityUpcomingPreventativeMaintenancesServiceListUpcomingPreventiveMaintenanceResponseBody>;
+    private __listUpcomingPreventiveMaintenance;
     /**
      * Gets work order templates. Optionally filter to specific template ids; ids that do not resolve to a template (e.g. deleted) are omitted from the response.
      *

package/dist/cjs/api/resources/betaApIs/client/Client.js

@@ -3413,6 +3413,96 @@ class BetaApIsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/functions/{name}/runs/{correlationId}");
         });
     }
+    /**
+     * Reassign one or more gateways to different devices in a single call. Mirrors the dashboard's "Pair Gateway" flow and accepts up to 50 gateway-device pairs per request. Works for any device type: vehicles, assets, equipment, trailers, industrial machines, and asset tags. By default, devices that the reassigned gateways were previously linked to remain in their current group. Pass `removeOrphanDevices: true` to move those orphaned devices to the unassigned group and clear their tags. The endpoint is currently in Beta and gated behind a feature configuration; contact your Samsara representative to enable access.
+     *
+     *  <b>Rate limit:</b> 100 requests/min (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+     *
+     * To use this endpoint, select **Write Gateways** under the Setup & Administration category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+     *
+     *
+     *  **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+     *
+     * @param {Samsara.GatewaysPairGatewaysRequestBody} request
+     * @param {BetaApIsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Samsara.UnauthorizedError}
+     * @throws {@link Samsara.NotFoundError}
+     * @throws {@link Samsara.MethodNotAllowedError}
+     * @throws {@link Samsara.TooManyRequestsError}
+     * @throws {@link Samsara.InternalServerError}
+     * @throws {@link Samsara.NotImplementedError}
+     * @throws {@link Samsara.BadGatewayError}
+     * @throws {@link Samsara.ServiceUnavailableError}
+     * @throws {@link Samsara.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.betaApIs.pairGateways({
+     *         pairs: [{
+     *                 deviceSerial: "GFRV-43N-VGX",
+     *                 gatewaySerial: "GFRV-43N-VGX"
+     *             }]
+     *     })
+     */
+    pairGateways(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__pairGateways(request, requestOptions));
+    }
+    __pairGateways(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "X-Samsara-Version": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.version }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.SamsaraEnvironment.ProductionApi, "gateways/pair"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Samsara.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Samsara.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 405:
+                        throw new Samsara.MethodNotAllowedError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Samsara.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Samsara.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 501:
+                        throw new Samsara.NotImplementedError(_response.error.body, _response.rawResponse);
+                    case 502:
+                        throw new Samsara.BadGatewayError(_response.error.body, _response.rawResponse);
+                    case 503:
+                        throw new Samsara.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                    case 504:
+                        throw new Samsara.GatewayTimeoutError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.SamsaraError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/gateways/pair");
+        });
+    }
     /**
      * Update the shippingDocs field of an existing assignment.
      *
@@ -3866,6 +3956,183 @@ class BetaApIsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "DELETE", "/hub/route-templates");
         });
     }
+    /**
+     * Returns a paginated list of preventive maintenance schedules for the organization.
+     *
+     *  <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+     *
+     * To use this endpoint, select **Read Preventive Maintenance Schedules** under the Preventive Maintenance category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+     *
+     *
+     *  **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+     *
+     * @param {Samsara.ListPreventiveMaintenanceSchedulesRequest} request
+     * @param {BetaApIsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Samsara.UnauthorizedError}
+     * @throws {@link Samsara.NotFoundError}
+     * @throws {@link Samsara.MethodNotAllowedError}
+     * @throws {@link Samsara.TooManyRequestsError}
+     * @throws {@link Samsara.InternalServerError}
+     * @throws {@link Samsara.NotImplementedError}
+     * @throws {@link Samsara.BadGatewayError}
+     * @throws {@link Samsara.ServiceUnavailableError}
+     * @throws {@link Samsara.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.betaApIs.listPreventiveMaintenanceSchedules()
+     */
+    listPreventiveMaintenanceSchedules(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listPreventiveMaintenanceSchedules(request, requestOptions));
+    }
+    __listPreventiveMaintenanceSchedules() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { idIn, after, limit } = request;
+            const _queryParams = {
+                idIn,
+                after,
+                limit,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "X-Samsara-Version": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.version }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.SamsaraEnvironment.ProductionApi, "maintenance/preventive/schedules"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Samsara.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Samsara.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 405:
+                        throw new Samsara.MethodNotAllowedError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Samsara.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Samsara.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 501:
+                        throw new Samsara.NotImplementedError(_response.error.body, _response.rawResponse);
+                    case 502:
+                        throw new Samsara.BadGatewayError(_response.error.body, _response.rawResponse);
+                    case 503:
+                        throw new Samsara.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                    case 504:
+                        throw new Samsara.GatewayTimeoutError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.SamsaraError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/maintenance/preventive/schedules");
+        });
+    }
+    /**
+     * Returns a paginated list of upcoming preventive maintenance schedules for the organization's assets, enriched with live telemetry (current odometer, engine hours) and due-date projections.
+     *
+     *  <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+     *
+     * To use this endpoint, select **Read Upcoming Preventive Maintenance** under the Preventive Maintenance category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+     *
+     *
+     *  **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+     *
+     * @param {Samsara.ListUpcomingPreventiveMaintenanceRequest} request
+     * @param {BetaApIsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Samsara.UnauthorizedError}
+     * @throws {@link Samsara.NotFoundError}
+     * @throws {@link Samsara.MethodNotAllowedError}
+     * @throws {@link Samsara.TooManyRequestsError}
+     * @throws {@link Samsara.InternalServerError}
+     * @throws {@link Samsara.NotImplementedError}
+     * @throws {@link Samsara.BadGatewayError}
+     * @throws {@link Samsara.ServiceUnavailableError}
+     * @throws {@link Samsara.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.betaApIs.listUpcomingPreventiveMaintenance()
+     */
+    listUpcomingPreventiveMaintenance(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listUpcomingPreventiveMaintenance(request, requestOptions));
+    }
+    __listUpcomingPreventiveMaintenance() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { preventativeMaintenanceScheduleIds, assetIds, after, limit } = request;
+            const _queryParams = {
+                preventativeMaintenanceScheduleIds,
+                assetIds,
+                after,
+                limit,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "X-Samsara-Version": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.version }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.SamsaraEnvironment.ProductionApi, "maintenance/preventive/upcoming"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Samsara.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Samsara.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 405:
+                        throw new Samsara.MethodNotAllowedError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Samsara.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Samsara.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 501:
+                        throw new Samsara.NotImplementedError(_response.error.body, _response.rawResponse);
+                    case 502:
+                        throw new Samsara.BadGatewayError(_response.error.body, _response.rawResponse);
+                    case 503:
+                        throw new Samsara.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                    case 504:
+                        throw new Samsara.GatewayTimeoutError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.SamsaraError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/maintenance/preventive/upcoming");
+        });
+    }
     /**
      * Gets work order templates. Optionally filter to specific template ids; ids that do not resolve to a template (e.g. deleted) are omitted from the response.
      *

package/dist/cjs/api/resources/betaApIs/client/requests/ListPreventiveMaintenanceSchedulesRequest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @example
+ *     {}
+ */
+export interface ListPreventiveMaintenanceSchedulesRequest {
+    /** A filter on the data based on this comma-separated list of ID values. */
+    idIn?: string;
+    /**  If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results. */
+    after?: string;
+    /** The limit for how many objects will be in the response. Default and max for this value is 200 objects. */
+    limit?: number;
+}

package/dist/cjs/api/resources/betaApIs/client/requests/ListUpcomingPreventiveMaintenanceRequest.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @example
+ *     {}
+ */
+export interface ListUpcomingPreventiveMaintenanceRequest {
+    /** A filter on the data based on this comma-separated list of Preventive Maintenance Schedule ID values. */
+    preventativeMaintenanceScheduleIds?: string;
+    /** A filter on the data based on this comma-separated list of Asset ID values. */
+    assetIds?: string;
+    /**  If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results. */
+    after?: string;
+    /** The limit for how many objects will be in the response. Default and max for this value is 200 objects. */
+    limit?: number;
+}

package/dist/cjs/api/resources/betaApIs/client/requests/ListUpcomingPreventiveMaintenanceRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/betaApIs/client/requests/index.d.ts

@@ -17,6 +17,7 @@ export type { FunctionsCreateFunctionRequestBody } from "./FunctionsCreateFuncti
 export type { FunctionsPatchFunctionRequestBody } from "./FunctionsPatchFunctionRequestBody.js";
 export type { FunctionsStartFunctionRunRequestBody } from "./FunctionsStartFunctionRunRequestBody.js";
 export type { FunctionsStorageCreateFunctionStorageFileRequestBody } from "./FunctionsStorageCreateFunctionStorageFileRequestBody.js";
+export type { GatewaysPairGatewaysRequestBody } from "./GatewaysPairGatewaysRequestBody.js";
 export type { GetAempEquipmentListRequest } from "./GetAempEquipmentListRequest.js";
 export type { GetAssetsInputsRequest } from "./GetAssetsInputsRequest.js";
 export type { GetDatasetsRequest } from "./GetDatasetsRequest.js";
@@ -55,9 +56,11 @@ export type { ListHubRouteTemplatesRequest } from "./ListHubRouteTemplatesReques
 export type { ListMaintenanceVendorsRequest } from "./ListMaintenanceVendorsRequest.js";
 export type { ListPlanOrdersRequest } from "./ListPlanOrdersRequest.js";
 export type { ListPreferredStationsRequest } from "./ListPreferredStationsRequest.js";
+export type { ListPreventiveMaintenanceSchedulesRequest } from "./ListPreventiveMaintenanceSchedulesRequest.js";
 export type { ListRidershipPassengersRequest } from "./ListRidershipPassengersRequest.js";
 export type { ListRidershipRouteSetupsRequest } from "./ListRidershipRouteSetupsRequest.js";
 export type { ListTachographLiveDataRequest } from "./ListTachographLiveDataRequest.js";
+export type { ListUpcomingPreventiveMaintenanceRequest } from "./ListUpcomingPreventiveMaintenanceRequest.js";
 export type { ListVendorCategoriesRequest } from "./ListVendorCategoriesRequest.js";
 export { PlacesPatchPlaceRequestBody } from "./PlacesPatchPlaceRequestBody.js";
 export { PlacesPostPlaceRequestBody } from "./PlacesPostPlaceRequestBody.js";

package/dist/cjs/api/resources/previewApIs/client/Client.d.ts

@@ -118,43 +118,4 @@ export declare class PreviewApIsClient {
      */
     unlockVehicle(request: Samsara.UnlockVehicleRequest, requestOptions?: PreviewApIsClient.RequestOptions): core.HttpResponsePromise<void>;
     private __unlockVehicle;
-    /**
-     * Reassign one or more gateways to different devices in a single call. Mirrors the dashboard's "Pair Gateway" flow and accepts up to 50 gateway-device pairs per request. Works for any device type: vehicles, assets, equipment, trailers, industrial machines, and asset tags. By default, devices that the reassigned gateways were previously linked to remain in their current group. Pass `removeOrphanDevices: true` to move those orphaned devices to the unassigned group and clear their tags. The endpoint is currently in Preview and gated behind a feature configuration; contact your Samsara representative to enable access.
-     *
-     *  <b>Rate limit:</b> 100 requests/min (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
-     *
-     * To use this endpoint, select **Write Gateways** under the Setup & Administration category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
-     *
-     * Endpoints in this section are in Preview. These APIs are not functional and are instead for soliciting feedback from our API users on the intended design of this API. Additionally, it is not guaranteed that we will be releasing an endpoint included in this section to production. This means that developers should **NOT** rely on these APIs to build business critical applications
-     *
-     * - Samsara may change the structure of a preview API's interface without versioning or any notice to API users.
-     *
-     * - When an endpoint becomes generally available, it will be announced in the API [changelog](https://developers.samsara.com/changelog).
-     *
-     *
-     *  **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
-     *
-     * @param {Samsara.GatewaysPairGatewaysRequestBody} request
-     * @param {PreviewApIsClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link Samsara.UnauthorizedError}
-     * @throws {@link Samsara.NotFoundError}
-     * @throws {@link Samsara.MethodNotAllowedError}
-     * @throws {@link Samsara.TooManyRequestsError}
-     * @throws {@link Samsara.InternalServerError}
-     * @throws {@link Samsara.NotImplementedError}
-     * @throws {@link Samsara.BadGatewayError}
-     * @throws {@link Samsara.ServiceUnavailableError}
-     * @throws {@link Samsara.GatewayTimeoutError}
-     *
-     * @example
-     *     await client.previewApIs.pairGateways({
-     *         pairs: [{
-     *                 deviceSerial: "GFRV-43N-VGX",
-     *                 gatewaySerial: "GFRV-43N-VGX"
-     *             }]
-     *     })
-     */
-    pairGateways(request: Samsara.GatewaysPairGatewaysRequestBody, requestOptions?: PreviewApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.GatewaysPairGatewaysResponseBody>;
-    private __pairGateways;
 }

package/dist/cjs/api/resources/previewApIs/client/Client.js

@@ -324,101 +324,5 @@ class PreviewApIsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "DELETE", "/preview/fleet/vehicles/{id}/lock");
         });
     }
-    /**
-     * Reassign one or more gateways to different devices in a single call. Mirrors the dashboard's "Pair Gateway" flow and accepts up to 50 gateway-device pairs per request. Works for any device type: vehicles, assets, equipment, trailers, industrial machines, and asset tags. By default, devices that the reassigned gateways were previously linked to remain in their current group. Pass `removeOrphanDevices: true` to move those orphaned devices to the unassigned group and clear their tags. The endpoint is currently in Preview and gated behind a feature configuration; contact your Samsara representative to enable access.
-     *
-     *  <b>Rate limit:</b> 100 requests/min (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
-     *
-     * To use this endpoint, select **Write Gateways** under the Setup & Administration category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
-     *
-     * Endpoints in this section are in Preview. These APIs are not functional and are instead for soliciting feedback from our API users on the intended design of this API. Additionally, it is not guaranteed that we will be releasing an endpoint included in this section to production. This means that developers should **NOT** rely on these APIs to build business critical applications
-     *
-     * - Samsara may change the structure of a preview API's interface without versioning or any notice to API users.
-     *
-     * - When an endpoint becomes generally available, it will be announced in the API [changelog](https://developers.samsara.com/changelog).
-     *
-     *
-     *  **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
-     *
-     * @param {Samsara.GatewaysPairGatewaysRequestBody} request
-     * @param {PreviewApIsClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link Samsara.UnauthorizedError}
-     * @throws {@link Samsara.NotFoundError}
-     * @throws {@link Samsara.MethodNotAllowedError}
-     * @throws {@link Samsara.TooManyRequestsError}
-     * @throws {@link Samsara.InternalServerError}
-     * @throws {@link Samsara.NotImplementedError}
-     * @throws {@link Samsara.BadGatewayError}
-     * @throws {@link Samsara.ServiceUnavailableError}
-     * @throws {@link Samsara.GatewayTimeoutError}
-     *
-     * @example
-     *     await client.previewApIs.pairGateways({
-     *         pairs: [{
-     *                 deviceSerial: "GFRV-43N-VGX",
-     *                 gatewaySerial: "GFRV-43N-VGX"
-     *             }]
-     *     })
-     */
-    pairGateways(request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__pairGateways(request, requestOptions));
-    }
-    __pairGateways(request, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "X-Samsara-Version": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.version }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
-            const _response = yield core.fetcher({
-                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.SamsaraEnvironment.ProductionApi, "preview/gateways/pair"),
-                method: "POST",
-                headers: _headers,
-                contentType: "application/json",
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                requestType: "json",
-                body: request,
-                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
-                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
-                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
-                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
-                logging: this._options.logging,
-            });
-            if (_response.ok) {
-                return {
-                    data: _response.body,
-                    rawResponse: _response.rawResponse,
-                };
-            }
-            if (_response.error.reason === "status-code") {
-                switch (_response.error.statusCode) {
-                    case 401:
-                        throw new Samsara.UnauthorizedError(_response.error.body, _response.rawResponse);
-                    case 404:
-                        throw new Samsara.NotFoundError(_response.error.body, _response.rawResponse);
-                    case 405:
-                        throw new Samsara.MethodNotAllowedError(_response.error.body, _response.rawResponse);
-                    case 429:
-                        throw new Samsara.TooManyRequestsError(_response.error.body, _response.rawResponse);
-                    case 500:
-                        throw new Samsara.InternalServerError(_response.error.body, _response.rawResponse);
-                    case 501:
-                        throw new Samsara.NotImplementedError(_response.error.body, _response.rawResponse);
-                    case 502:
-                        throw new Samsara.BadGatewayError(_response.error.body, _response.rawResponse);
-                    case 503:
-                        throw new Samsara.ServiceUnavailableError(_response.error.body, _response.rawResponse);
-                    case 504:
-                        throw new Samsara.GatewayTimeoutError(_response.error.body, _response.rawResponse);
-                    default:
-                        throw new errors.SamsaraError({
-                            statusCode: _response.error.statusCode,
-                            body: _response.error.body,
-                            rawResponse: _response.rawResponse,
-                        });
-                }
-            }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/preview/gateways/pair");
-        });
-    }
 }
 exports.PreviewApIsClient = PreviewApIsClient;

package/dist/cjs/api/resources/previewApIs/client/requests/index.d.ts

@@ -1,4 +1,3 @@
 export type { DriversAuthTokenCreateDriverAuthTokenRequestBody } from "./DriversAuthTokenCreateDriverAuthTokenRequestBody.js";
-export type { GatewaysPairGatewaysRequestBody } from "./GatewaysPairGatewaysRequestBody.js";
 export type { LockVehicleRequest } from "./LockVehicleRequest.js";
 export type { UnlockVehicleRequest } from "./UnlockVehicleRequest.js";

package/dist/cjs/api/types/CreateRoutesStopRequestObjectRequestBody.d.ts

@@ -3,7 +3,7 @@ export interface CreateRoutesStopRequestObjectRequestBody {
     /** ID of the address. An address [externalId](https://developers.samsara.com/docs/external-ids#using-external-ids) can also be used interchangeably here. */
     addressId?: string | undefined;
     /** Appointment windows for the stop. */
-    appointmentWindows?: Samsara.HosViolationDayObjectRequestBody[] | undefined;
+    appointmentWindows?: Samsara.RouteStopAppointmentWindowRequestBody[] | undefined;
     /** A map of external ids */
     externalIds?: Record<string, string> | undefined;
     /** Name of the stop */