@samsarahq/samsara 13.21.0 → 13.23.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.21.0",
-        "User-Agent": "@samsarahq/samsara/13.21.0",
+        "X-Fern-SDK-Version": "13.23.0",
+        "User-Agent": "@samsarahq/samsara/13.23.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/alerts/client/Client.d.ts

@@ -117,7 +117,7 @@ export declare class AlertsClient {
      *         isEnabled: true,
      *         name: "My Harsh Event Alert",
      *         scope: {
-     *             all: true
+     *             all: false
      *         },
      *         triggers: [{
      *                 triggerTypeId: 1000

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

@@ -223,7 +223,7 @@ class AlertsClient {
      *         isEnabled: true,
      *         name: "My Harsh Event Alert",
      *         scope: {
-     *             all: true
+     *             all: false
      *         },
      *         triggers: [{
      *                 triggerTypeId: 1000

package/dist/cjs/api/resources/alerts/client/requests/AlertsPostConfigurationsRequestBody.d.ts

@@ -8,7 +8,7 @@ import type * as Samsara from "../../../../index.js";
  *         isEnabled: true,
  *         name: "My Harsh Event Alert",
  *         scope: {
- *             all: true
+ *             all: false
  *         },
  *         triggers: [{
  *                 triggerTypeId: 1000

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

@@ -267,7 +267,7 @@ export declare class BetaApIsClient {
      *         id: 1000000,
      *         relayStates: [{
      *                 id: "relay1",
-     *                 isOpen: true
+     *                 isOpen: false
      *             }]
      *     })
      */
@@ -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.
      *
@@ -1380,6 +1469,7 @@ export declare class BetaApIsClient {
      * @example
      *     await client.betaApIs.postPlace({
      *         address: "123 Main St, Oakland, CA",
+     *         geofence: {},
      *         name: "Oakland Yard"
      *     })
      */
@@ -1902,19 +1992,14 @@ export declare class BetaApIsClient {
      * * `engineRpm`
      * * `engineState` (values: off | running | idling)
      * * `faultCodes`
-     * * `faultCodesJ1939`
-     * * `faultCodesOBDII`
      * * `fuelLevelPerc`
      * * `gps`
-     * * `location`
      * * `odometerEcu`
      * * `oilPressure`
      *
      * </details>
      *
-     * **Note:** Use the `GET /readings/definitions` endpoint and check the `ingestionEnabled` field for the authoritative, up-to-date set of ingestible readings for your organization.
-     *
-     * When ingesting location data, the readingID 'location' must be used and the value object must contain at least the following fields: 'speed', 'latitude', 'longitude'.
+     * When ingesting GPS location data, use the readingID 'gps'. The value object must contain the following fields: 'latitude' (decimal degrees), 'longitude' (decimal degrees), and 'speed' (meters per second).
      *
      * Related guide: [Readings](https://developers.samsara.com/docs/readings).
      *
@@ -2430,7 +2515,7 @@ export declare class BetaApIsClient {
      *
      * @example
      *     await client.betaApIs.patchSafetyEventsV2Batch({
-     *         safetyEventIds: ["bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590", "bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590", "bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590"]
+     *         safetyEventIds: ["bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590", "bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590", "bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590", "bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590"]
      *     })
      */
     patchSafetyEventsV2Batch(request: Samsara.SafetyEventsV2PatchSafetyEventsV2BatchRequestBody, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.SafetyEventsV2PatchSafetyEventsV2BatchResponseBody>;

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

@@ -790,7 +790,7 @@ class BetaApIsClient {
      *         id: 1000000,
      *         relayStates: [{
      *                 id: "relay1",
-     *                 isOpen: true
+     *                 isOpen: false
      *             }]
      *     })
      */
@@ -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.
      *
@@ -4071,6 +4338,7 @@ class BetaApIsClient {
      * @example
      *     await client.betaApIs.postPlace({
      *         address: "123 Main St, Oakland, CA",
+     *         geofence: {},
      *         name: "Oakland Yard"
      *     })
      */
@@ -5571,19 +5839,14 @@ class BetaApIsClient {
      * * `engineRpm`
      * * `engineState` (values: off | running | idling)
      * * `faultCodes`
-     * * `faultCodesJ1939`
-     * * `faultCodesOBDII`
      * * `fuelLevelPerc`
      * * `gps`
-     * * `location`
      * * `odometerEcu`
      * * `oilPressure`
      *
      * </details>
      *
-     * **Note:** Use the `GET /readings/definitions` endpoint and check the `ingestionEnabled` field for the authoritative, up-to-date set of ingestible readings for your organization.
-     *
-     * When ingesting location data, the readingID 'location' must be used and the value object must contain at least the following fields: 'speed', 'latitude', 'longitude'.
+     * When ingesting GPS location data, use the readingID 'gps'. The value object must contain the following fields: 'latitude' (decimal degrees), 'longitude' (decimal degrees), and 'speed' (meters per second).
      *
      * Related guide: [Readings](https://developers.samsara.com/docs/readings).
      *
@@ -7031,7 +7294,7 @@ class BetaApIsClient {
      *
      * @example
      *     await client.betaApIs.patchSafetyEventsV2Batch({
-     *         safetyEventIds: ["bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590", "bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590", "bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590"]
+     *         safetyEventIds: ["bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590", "bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590", "bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590", "bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590"]
      *     })
      */
     patchSafetyEventsV2Batch(request, requestOptions) {

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

@@ -5,7 +5,7 @@ import type * as Samsara from "../../../../index.js";
  *         id: 1000000,
  *         relayStates: [{
  *                 id: "relay1",
- *                 isOpen: true
+ *                 isOpen: false
  *             }]
  *     }
  */

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/PlacesPatchPlaceRequestBody.d.ts

@@ -14,29 +14,22 @@ export interface PlacesPatchPlaceRequestBody {
     cameraRecordingModeType?: PlacesPatchPlaceRequestBody.CameraRecordingModeType;
     /** When present, replaces external ids for the place. */
     externalIds?: PlacesPatchPlaceRequestBody.ExternalIds;
-    /** Polygon vertices; at least three when switching to polygon mode. */
-    geofence?: Samsara.GeofenceVertexInputRequestBody[];
-    hubLocations?: Samsara.PatchPlaceHubLocationsBodyRequestBody;
+    geofence?: Samsara.PlaceGeofenceInputRequestBody;
     /** When present, replaces IFTA exemption types for the place. */
     iftaExemptionTypes?: string[];
     /** When true, show addresses inside the geofence on the map. */
     isShowAddressesEnabled?: boolean;
-    /** Center latitude when switching to or editing a circle geofence. */
-    latitude?: number;
-    /** Center longitude when switching to or editing a circle geofence. */
-    longitude?: number;
     /** Place name. */
     name?: string;
     navigation?: Samsara.PostPlaceNavigationInputRequestBody;
     /** Notes. */
     notes?: string;
-    /** When present, replaces address-type categories via address metadata. Metadata-derived types (hubLocation, navigation, iftaExemption) must match hubLocations, navigation, and IFTA metadata after this request; conflicting combinations return InvalidArgument. */
+    /** When present, replaces address-type categories via address metadata. Metadata-derived types (hubLocation, navigation, iftaExemption) must match routing, navigation, and IFTA metadata after this request; conflicting combinations return InvalidArgument. */
     placeTypes?: string[];
-    /** Circle radius in meters; use with latitude and longitude. */
-    radiusMeters?: number;
+    routing?: Samsara.PlaceRoutingPatchInputRequestBody;
     /** When present, replaces safety event exclusions for the place. */
     safetyEventExclusions?: string[];
-    streetView?: Samsara.PlaceStreetViewResponseRequestBody;
+    streetView?: Samsara.PlaceStreetViewInputRequestBody;
     /** When present, replaces all tag associations for the place. */
     tags?: Samsara.PostPlaceTagRefRequestBody[];
 }

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

@@ -3,6 +3,7 @@ import type * as Samsara from "../../../../index.js";
  * @example
  *     {
  *         address: "123 Main St, Oakland, CA",
+ *         geofence: {},
  *         name: "Oakland Yard"
  *     }
  */
@@ -13,30 +14,23 @@ export interface PlacesPostPlaceRequestBody {
     cameraRecordingModeType?: PlacesPostPlaceRequestBody.CameraRecordingModeType;
     /** External identifiers. */
     externalIds?: PlacesPostPlaceRequestBody.ExternalIds;
-    /** Polygon vertices; at least three when using polygon mode (omit entirely when using latitude, longitude, and radiusMeters for a circle). */
-    geofence?: Samsara.GeofenceVertexInputRequestBody[];
-    /** Initial route-planning hub rows for the new place. Each entry requires hubId. Omit hubLocationId to let the server assign a row UUID, or set hubLocationId to pin the UUID for idempotent creates. */
-    hubLocations?: Samsara.PatchPlaceHubLocationUpsertBodyRequestBody[];
+    geofence: Samsara.PlaceGeofenceInputRequestBody;
     /** IFTA exemption types for this place. */
     iftaExemptionTypes?: string[];
     /** When true, show addresses inside the geofence on the map. */
     isShowAddressesEnabled?: boolean;
-    /** Center latitude when using a circle geofence with radiusMeters. */
-    latitude?: number;
-    /** Center longitude when using a circle geofence with radiusMeters. */
-    longitude?: number;
     /** Place name. */
     name: string;
     navigation?: Samsara.PostPlaceNavigationInputRequestBody;
     /** Optional notes. */
     notes?: string;
-    /** When present, replaces address-type categories via address metadata. Metadata-derived types (hubLocation, navigation, iftaExemption) must match hubLocations, navigation, and existing IFTA metadata in the same request; conflicting combinations return InvalidArgument. */
+    /** When present, replaces address-type categories via address metadata. Metadata-derived types (hubLocation, navigation, iftaExemption) must match routing, navigation, and existing IFTA metadata in the same request; conflicting combinations return InvalidArgument. */
     placeTypes?: string[];
-    /** Circle radius in meters; requires latitude and longitude. Must be at least 1 when set. */
-    radiusMeters?: number;
+    /** Initial route-planning rows for the new place. Each entry requires hubId; (placeId, hubId) must be unique. */
+    routing?: Samsara.PlaceRoutingInputRequestBody[];
     /** Safety event types excluded at this place. */
     safetyEventExclusions?: string[];
-    streetView?: Samsara.PlaceStreetViewResponseRequestBody;
+    streetView?: Samsara.PlaceStreetViewInputRequestBody;
     /** Tags to associate. */
     tags?: Samsara.PostPlaceTagRefRequestBody[];
 }