@samsarahq/samsara 13.29.0 → 13.31.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.29.0",
-        "User-Agent": "@samsarahq/samsara/13.29.0",
+        "X-Fern-SDK-Version": "13.31.0",
+        "User-Agent": "@samsarahq/samsara/13.31.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/assets/client/requests/AssetsCreateAssetRequestBody.d.ts

@@ -4,7 +4,7 @@ import type * as Samsara from "../../../../index.js";
  *     {}
  */
 export interface AssetsCreateAssetRequestBody {
-    /** A list of attributes to assign to the asset. */
+    /** A list of attributes to assign to the asset. If provided, this replaces the asset's entire set of attribute associations with exactly this list; omit this field to leave existing attribute associations unchanged, or pass an empty array to clear them. */
     attributes?: Samsara.GoaAttributeTinyRequestBody[];
     /** A map of external ids */
     externalIds?: Record<string, string>;
@@ -24,7 +24,7 @@ export interface AssetsCreateAssetRequestBody {
     regulationMode?: AssetsCreateAssetRequestBody.RegulationMode;
     /** The serial number of the asset. This can be an internal serial number or used to hold legacy VIN/PIN numbers such as ones of shorter lengths. */
     serialNumber?: string;
-    /** An array of IDs of tags to associate with this asset. If your access to the API is scoped by one or more tags, this field is required to pass in. */
+    /** An array of IDs of tags to associate with this asset. If provided, this replaces the asset's entire set of tag associations with exactly this list; omit this field to leave existing tag associations unchanged, or pass an empty array to clear them. If your access to the API is scoped by one or more tags, this field is required to pass in. */
     tagIds?: string[];
     /** The operational context in which the asset interacts with the Samsara system. Examples: Vehicle (eg: truck, bus...), Trailer (eg: dry van, reefer, flatbed...), Powered Equipment (eg: dozer, crane...), Unpowered Equipment (eg: container, dumpster...), or Uncategorized.  Valid values: `uncategorized`, `trailer`, `equipment`, `unpowered`, `vehicle` */
     type?: AssetsCreateAssetRequestBody.Type;

package/dist/cjs/api/resources/assets/client/requests/AssetsUpdateAssetRequestBody.d.ts

@@ -1,3 +1,4 @@
+import type * as Samsara from "../../../../index.js";
 /**
  * @example
  *     {
@@ -7,6 +8,8 @@
 export interface AssetsUpdateAssetRequestBody {
     /** A filter selecting a single asset by id. */
     id: string;
+    /** A list of attributes to assign to the asset. If provided, this replaces the asset's entire set of attribute associations with exactly this list; omit this field to leave existing attribute associations unchanged, or pass an empty array to clear them. */
+    attributes?: Samsara.GoaAttributeTinyRequestBody[];
     /** A map of external ids */
     externalIds?: Record<string, string>;
     /** The license plate of the asset. */
@@ -25,6 +28,8 @@ export interface AssetsUpdateAssetRequestBody {
     regulationMode?: AssetsUpdateAssetRequestBody.RegulationMode;
     /** The serial number of the asset. This can be an internal serial number or used to hold legacy VIN/PIN numbers such as ones of shorter lengths. */
     serialNumber?: string;
+    /** An array of IDs of tags to associate with this asset. If provided, this replaces the asset's entire set of tag associations with exactly this list; omit this field to leave existing tag associations unchanged, or pass an empty array to clear them. If your access to the API is scoped by one or more tags, this field is required to pass in. */
+    tagIds?: string[];
     /** The operational context in which the asset interacts with the Samsara system. Examples: Vehicle (eg: truck, bus...), Trailer (eg: dry van, reefer, flatbed...), Powered Equipment (eg: dozer, crane...), Unpowered Equipment (eg: container, dumpster...), or Uncategorized.  Valid values: `uncategorized`, `trailer`, `equipment`, `unpowered`, `vehicle` */
     type?: AssetsUpdateAssetRequestBody.Type;
     /** The unique 17-digit VIN (Vehicle Identification Number) or PIN (Product Identification Number) of the asset. */

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

@@ -2632,7 +2632,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", "bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590"]
+     *         safetyEventIds: ["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

@@ -7585,7 +7585,7 @@ class BetaApIsClient {
      *
      * @example
      *     await client.betaApIs.patchSafetyEventsV2Batch({
-     *         safetyEventIds: ["bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590", "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"]
      *     })
      */
     patchSafetyEventsV2Batch(request, requestOptions) {

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

@@ -2,7 +2,7 @@ import type * as Samsara from "../../../../index.js";
 /**
  * @example
  *     {
- *         safetyEventIds: ["bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590", "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"]
  *     }
  */
 export interface SafetyEventsV2PatchSafetyEventsV2BatchRequestBody {

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

@@ -98,7 +98,7 @@ export declare class MediaClient {
      * @example
      *     await client.media.postMediaRetrieval({
      *         endTime: "2019-06-13T19:08:55Z",
-     *         inputs: ["dashcamRoadFacing", "dashcamRoadFacing", "dashcamRoadFacing"],
+     *         inputs: ["dashcamRoadFacing", "dashcamRoadFacing", "dashcamRoadFacing", "dashcamRoadFacing"],
      *         mediaType: "image",
      *         startTime: "2019-06-13T19:08:25Z",
      *         vehicleId: "1234"

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

@@ -274,7 +274,7 @@ class MediaClient {
      * @example
      *     await client.media.postMediaRetrieval({
      *         endTime: "2019-06-13T19:08:55Z",
-     *         inputs: ["dashcamRoadFacing", "dashcamRoadFacing", "dashcamRoadFacing"],
+     *         inputs: ["dashcamRoadFacing", "dashcamRoadFacing", "dashcamRoadFacing", "dashcamRoadFacing"],
      *         mediaType: "image",
      *         startTime: "2019-06-13T19:08:25Z",
      *         vehicleId: "1234"

package/dist/cjs/api/resources/media/client/requests/MediaRetrievalPostMediaRetrievalRequestBody.d.ts

@@ -2,7 +2,7 @@
  * @example
  *     {
  *         endTime: "2019-06-13T19:08:55Z",
- *         inputs: ["dashcamRoadFacing", "dashcamRoadFacing", "dashcamRoadFacing"],
+ *         inputs: ["dashcamRoadFacing", "dashcamRoadFacing", "dashcamRoadFacing", "dashcamRoadFacing"],
  *         mediaType: "image",
  *         startTime: "2019-06-13T19:08:25Z",
  *         vehicleId: "1234"

package/dist/cjs/api/resources/readings/client/requests/GetReadingsHistoryRequest.d.ts

@@ -221,9 +221,6 @@ export interface GetReadingsHistoryRequest {
      *
      * * `addressEntry` (Address Entry): Address data from the address entry event
      * * `addressExit` (Address Exit): Address data from the address exit event
-     * * `ag51BatteryStatus` (AG51 Battery Status): Battery status of the AG51 gateway based on temperature-compensated voltage threshold. The threshold varies from 3672mV at -40°C to 4579mV at 60°C. (values: ok | low)
-     * * `ag51BatteryTemperature` (AG51 Battery Temperature): Internal temperature of the AG51 gateway battery in degrees Celsius (celsius)
-     * * `ag51BatteryVoltage` (AG51 Battery Voltage): Total battery voltage of the AG51 gateway (sum of all 3 cells) in volts (volt)
      * * `atisLamp` (Atis Lamp status): Atis lamp on/off status (values: off | on)
      * * `derivedCargoState` (Cargo Status): Indicates if the overall cargo status of the asset is Empty, Partially Empty, Full, or Unknown. (values: unknown | empty | partiallyEmpty | full)
      * * `doorClosedStatus` (Door Closed Status): Status indicating whether a door is closed or open (values: open | closed)
@@ -232,6 +229,9 @@ export interface GetReadingsHistoryRequest {
      * * `environmentMonitorAmbientTemperatureBLEConnection` (Ambient Temperature (BLE Connection)): Air temperature at the environmental monitor device (built-in sensor) via BLE Connection. (celsius)
      * * `environmentMonitorThermistorTemperature` (Thermistor Temperature): Temperature from an external thermistor probe (e.g. cable probe in cargo or reefer). (celsius)
      * * `environmentMonitorThermistorTemperatureBLEConnection` (Thermistor Temperature (BLE Connection)): Temperature from an external thermistor probe (e.g. cable probe in cargo or reefer) via BLE Connection. (celsius)
+     * * `gatewayBatteryStatus` (Gateway Battery Status): Battery status of the gateway based on temperature-compensated voltage threshold. The threshold varies from 3672mV at -40°C to 4579mV at 60°C. (values: ok | low)
+     * * `gatewayBatteryTemperature` (Gateway Battery Temperature): Internal temperature of the gateway battery in degrees Celsius (celsius)
+     * * `gatewayBatteryVoltage` (Gateway Battery Voltage): Total battery voltage of the gateway (sum of all 3 cells) in volts (volt)
      * * `trailerMovingWithoutPower` (Trailer Moving Without Power): Trailer moving without power status (values: off | on)
      * * `validBrakeScore` (Braking Performance Value): Percent score representing trailer braking effectiveness using regression analysis over the past 90 days, guaranteed to have under 3% margin of error. (percent)
      * * `widgetBatteryVoltage` (Widget Battery Voltage): Battery voltage level of the widget sensor in millivolts (volt)

package/dist/cjs/api/resources/readings/client/requests/GetReadingsSnapshotRequest.d.ts

@@ -221,9 +221,6 @@ export interface GetReadingsSnapshotRequest {
      *
      * * `addressEntry` (Address Entry): Address data from the address entry event
      * * `addressExit` (Address Exit): Address data from the address exit event
-     * * `ag51BatteryStatus` (AG51 Battery Status): Battery status of the AG51 gateway based on temperature-compensated voltage threshold. The threshold varies from 3672mV at -40°C to 4579mV at 60°C. (values: ok | low)
-     * * `ag51BatteryTemperature` (AG51 Battery Temperature): Internal temperature of the AG51 gateway battery in degrees Celsius (celsius)
-     * * `ag51BatteryVoltage` (AG51 Battery Voltage): Total battery voltage of the AG51 gateway (sum of all 3 cells) in volts (volt)
      * * `atisLamp` (Atis Lamp status): Atis lamp on/off status (values: off | on)
      * * `derivedCargoState` (Cargo Status): Indicates if the overall cargo status of the asset is Empty, Partially Empty, Full, or Unknown. (values: unknown | empty | partiallyEmpty | full)
      * * `doorClosedStatus` (Door Closed Status): Status indicating whether a door is closed or open (values: open | closed)
@@ -232,6 +229,9 @@ export interface GetReadingsSnapshotRequest {
      * * `environmentMonitorAmbientTemperatureBLEConnection` (Ambient Temperature (BLE Connection)): Air temperature at the environmental monitor device (built-in sensor) via BLE Connection. (celsius)
      * * `environmentMonitorThermistorTemperature` (Thermistor Temperature): Temperature from an external thermistor probe (e.g. cable probe in cargo or reefer). (celsius)
      * * `environmentMonitorThermistorTemperatureBLEConnection` (Thermistor Temperature (BLE Connection)): Temperature from an external thermistor probe (e.g. cable probe in cargo or reefer) via BLE Connection. (celsius)
+     * * `gatewayBatteryStatus` (Gateway Battery Status): Battery status of the gateway based on temperature-compensated voltage threshold. The threshold varies from 3672mV at -40°C to 4579mV at 60°C. (values: ok | low)
+     * * `gatewayBatteryTemperature` (Gateway Battery Temperature): Internal temperature of the gateway battery in degrees Celsius (celsius)
+     * * `gatewayBatteryVoltage` (Gateway Battery Voltage): Total battery voltage of the gateway (sum of all 3 cells) in volts (volt)
      * * `trailerMovingWithoutPower` (Trailer Moving Without Power): Trailer moving without power status (values: off | on)
      * * `validBrakeScore` (Braking Performance Value): Percent score representing trailer braking effectiveness using regression analysis over the past 90 days, guaranteed to have under 3% margin of error. (percent)
      * * `widgetBatteryVoltage` (Widget Battery Voltage): Battery voltage level of the widget sensor in millivolts (volt)

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

@@ -0,0 +1,19 @@
+/**
+ * BLE asset tag-specific health metadata details.
+ */
+export interface BleAssetTagDetailsResponseResponseBody {
+    /** The BLE asset tag's battery state.  Valid values: `critical`, `low`, `ok`, `unknown` */
+    batteryState?: BleAssetTagDetailsResponseResponseBody.BatteryState | undefined;
+    /** The timestamp when the BLE asset tag was last detected by a gateway in the Samsara network, in RFC 3339 format. */
+    lastCheckInTime?: string | undefined;
+}
+export declare namespace BleAssetTagDetailsResponseResponseBody {
+    /** The BLE asset tag's battery state.  Valid values: `critical`, `low`, `ok`, `unknown` */
+    const BatteryState: {
+        readonly Critical: "critical";
+        readonly Low: "low";
+        readonly Ok: "ok";
+        readonly Unknown: "unknown";
+    };
+    type BatteryState = (typeof BatteryState)[keyof typeof BatteryState];
+}

package/dist/cjs/api/types/BleAssetTagDetailsResponseResponseBody.js

@@ -0,0 +1,14 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BleAssetTagDetailsResponseResponseBody = void 0;
+var BleAssetTagDetailsResponseResponseBody;
+(function (BleAssetTagDetailsResponseResponseBody) {
+    /** The BLE asset tag's battery state.  Valid values: `critical`, `low`, `ok`, `unknown` */
+    BleAssetTagDetailsResponseResponseBody.BatteryState = {
+        Critical: "critical",
+        Low: "low",
+        Ok: "ok",
+        Unknown: "unknown",
+    };
+})(BleAssetTagDetailsResponseResponseBody || (exports.BleAssetTagDetailsResponseResponseBody = BleAssetTagDetailsResponseResponseBody = {}));

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

@@ -0,0 +1,11 @@
+/**
+ * Camera connector-specific health metadata details.
+ */
+export interface CameraConnectorDetailsResponseResponseBody {
+    /** The timestamp when the gateway was last connected to the vehicle, in RFC 3339 format. */
+    gatewayLastConnectedTime?: string | undefined;
+    /** The percentage of successful recording time during the time when the vehicle is on an active trip over the past 50 hours, in percentage points. */
+    lastFiftyHoursUptimePercentage?: number | undefined;
+    /** The serial number of the vehicle gateway that the camera connector is connected to. */
+    vehicleGatewaySerial?: string | undefined;
+}

package/dist/cjs/api/types/CameraConnectorDetailsResponseResponseBody.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/types/HealthDetailsResponseResponseBody.d.ts

@@ -3,6 +3,8 @@ import type * as Samsara from "../index.js";
  * Detailed health related metadata for the device.
  */
 export interface HealthDetailsResponseResponseBody {
+    bleAssetTagDetails?: Samsara.BleAssetTagDetailsResponseResponseBody | undefined;
+    cameraConnectorDetails?: Samsara.CameraConnectorDetailsResponseResponseBody | undefined;
     cameraDetails?: Samsara.CameraDetailsResponseResponseBody | undefined;
     gatewayDetails?: Samsara.GatewayDetailsResponseResponseBody | undefined;
 }

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

@@ -5,6 +5,8 @@ import type * as Samsara from "../index.js";
 export interface TrailerStatsObjectResponseBody {
     /** A list of engine state points. */
     carrierReeferState?: Samsara.TrailerStatReeferStateWithDecorationsTypeResponseBody[] | undefined;
+    /** A map of external ids */
+    externalIds?: Record<string, string> | undefined;
     /** A list of GPS points. */
     gps?: Samsara.TrailerStatGpsWithDecorationsTypeResponseBody[] | undefined;
     /** A list of odometer points. */

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

@@ -4,6 +4,8 @@ import type * as Samsara from "../index.js";
  */
 export interface TrailerStatsSnapshotObjectResponseBody {
     carrierReeferState?: Samsara.TrailerStatReeferStateTypeResponseBody | undefined;
+    /** A map of external ids */
+    externalIds?: Record<string, string> | undefined;
     gps?: Samsara.TrailerStatGpsTypeResponseBody | undefined;
     gpsOdometerMeters?: Samsara.TrailerStatGpsOdometerMetersTypeResponseBody | undefined;
     /** ID of the trailer. */

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

@@ -233,6 +233,8 @@ export * from "./BaseRouteResponseObjectResponseBody.js";
 export * from "./BehaviorCountDetailsRequestBody.js";
 export * from "./BehaviorCountDetailsResponseBody.js";
 export * from "./BehaviorResponseBody.js";
+export * from "./BleAssetTagDetailsResponseResponseBody.js";
+export * from "./CameraConnectorDetailsResponseResponseBody.js";
 export * from "./CameraConnectorDisconectedResponseBody.js";
 export * from "./CameraDetailsResponseResponseBody.js";
 export * from "./CameraSerial.js";

package/dist/cjs/api/types/index.js

@@ -249,6 +249,8 @@ __exportStar(require("./BaseRouteResponseObjectResponseBody.js"), exports);
 __exportStar(require("./BehaviorCountDetailsRequestBody.js"), exports);
 __exportStar(require("./BehaviorCountDetailsResponseBody.js"), exports);
 __exportStar(require("./BehaviorResponseBody.js"), exports);
+__exportStar(require("./BleAssetTagDetailsResponseResponseBody.js"), exports);
+__exportStar(require("./CameraConnectorDetailsResponseResponseBody.js"), exports);
 __exportStar(require("./CameraConnectorDisconectedResponseBody.js"), exports);
 __exportStar(require("./CameraDetailsResponseResponseBody.js"), exports);
 __exportStar(require("./CameraSerial.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "13.29.0";
+export declare const SDK_VERSION = "13.31.0";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "13.29.0";
+exports.SDK_VERSION = "13.31.0";

package/dist/esm/BaseClient.mjs

@@ -7,8 +7,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@samsarahq/samsara",
-        "X-Fern-SDK-Version": "13.29.0",
-        "User-Agent": "@samsarahq/samsara/13.29.0",
+        "X-Fern-SDK-Version": "13.31.0",
+        "User-Agent": "@samsarahq/samsara/13.31.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/esm/api/resources/assets/client/requests/AssetsCreateAssetRequestBody.d.mts

@@ -4,7 +4,7 @@ import type * as Samsara from "../../../../index.mjs";
  *     {}
  */
 export interface AssetsCreateAssetRequestBody {
-    /** A list of attributes to assign to the asset. */
+    /** A list of attributes to assign to the asset. If provided, this replaces the asset's entire set of attribute associations with exactly this list; omit this field to leave existing attribute associations unchanged, or pass an empty array to clear them. */
     attributes?: Samsara.GoaAttributeTinyRequestBody[];
     /** A map of external ids */
     externalIds?: Record<string, string>;
@@ -24,7 +24,7 @@ export interface AssetsCreateAssetRequestBody {
     regulationMode?: AssetsCreateAssetRequestBody.RegulationMode;
     /** The serial number of the asset. This can be an internal serial number or used to hold legacy VIN/PIN numbers such as ones of shorter lengths. */
     serialNumber?: string;
-    /** An array of IDs of tags to associate with this asset. If your access to the API is scoped by one or more tags, this field is required to pass in. */
+    /** An array of IDs of tags to associate with this asset. If provided, this replaces the asset's entire set of tag associations with exactly this list; omit this field to leave existing tag associations unchanged, or pass an empty array to clear them. If your access to the API is scoped by one or more tags, this field is required to pass in. */
     tagIds?: string[];
     /** The operational context in which the asset interacts with the Samsara system. Examples: Vehicle (eg: truck, bus...), Trailer (eg: dry van, reefer, flatbed...), Powered Equipment (eg: dozer, crane...), Unpowered Equipment (eg: container, dumpster...), or Uncategorized.  Valid values: `uncategorized`, `trailer`, `equipment`, `unpowered`, `vehicle` */
     type?: AssetsCreateAssetRequestBody.Type;

package/dist/esm/api/resources/assets/client/requests/AssetsUpdateAssetRequestBody.d.mts

@@ -1,3 +1,4 @@
+import type * as Samsara from "../../../../index.mjs";
 /**
  * @example
  *     {
@@ -7,6 +8,8 @@
 export interface AssetsUpdateAssetRequestBody {
     /** A filter selecting a single asset by id. */
     id: string;
+    /** A list of attributes to assign to the asset. If provided, this replaces the asset's entire set of attribute associations with exactly this list; omit this field to leave existing attribute associations unchanged, or pass an empty array to clear them. */
+    attributes?: Samsara.GoaAttributeTinyRequestBody[];
     /** A map of external ids */
     externalIds?: Record<string, string>;
     /** The license plate of the asset. */
@@ -25,6 +28,8 @@ export interface AssetsUpdateAssetRequestBody {
     regulationMode?: AssetsUpdateAssetRequestBody.RegulationMode;
     /** The serial number of the asset. This can be an internal serial number or used to hold legacy VIN/PIN numbers such as ones of shorter lengths. */
     serialNumber?: string;
+    /** An array of IDs of tags to associate with this asset. If provided, this replaces the asset's entire set of tag associations with exactly this list; omit this field to leave existing tag associations unchanged, or pass an empty array to clear them. If your access to the API is scoped by one or more tags, this field is required to pass in. */
+    tagIds?: string[];
     /** The operational context in which the asset interacts with the Samsara system. Examples: Vehicle (eg: truck, bus...), Trailer (eg: dry van, reefer, flatbed...), Powered Equipment (eg: dozer, crane...), Unpowered Equipment (eg: container, dumpster...), or Uncategorized.  Valid values: `uncategorized`, `trailer`, `equipment`, `unpowered`, `vehicle` */
     type?: AssetsUpdateAssetRequestBody.Type;
     /** The unique 17-digit VIN (Vehicle Identification Number) or PIN (Product Identification Number) of the asset. */

package/dist/esm/api/resources/betaApIs/client/Client.d.mts

@@ -2632,7 +2632,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", "bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590"]
+     *         safetyEventIds: ["bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590", "bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590"]
      *     })
      */
     patchSafetyEventsV2Batch(request: Samsara.SafetyEventsV2PatchSafetyEventsV2BatchRequestBody, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.SafetyEventsV2PatchSafetyEventsV2BatchResponseBody>;

package/dist/esm/api/resources/betaApIs/client/Client.mjs

@@ -7549,7 +7549,7 @@ export class BetaApIsClient {
      *
      * @example
      *     await client.betaApIs.patchSafetyEventsV2Batch({
-     *         safetyEventIds: ["bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590", "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"]
      *     })
      */
     patchSafetyEventsV2Batch(request, requestOptions) {

package/dist/esm/api/resources/betaApIs/client/requests/SafetyEventsV2PatchSafetyEventsV2BatchRequestBody.d.mts

@@ -2,7 +2,7 @@ import type * as Samsara from "../../../../index.mjs";
 /**
  * @example
  *     {
- *         safetyEventIds: ["bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590", "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"]
  *     }
  */
 export interface SafetyEventsV2PatchSafetyEventsV2BatchRequestBody {

package/dist/esm/api/resources/media/client/Client.d.mts

@@ -98,7 +98,7 @@ export declare class MediaClient {
      * @example
      *     await client.media.postMediaRetrieval({
      *         endTime: "2019-06-13T19:08:55Z",
-     *         inputs: ["dashcamRoadFacing", "dashcamRoadFacing", "dashcamRoadFacing"],
+     *         inputs: ["dashcamRoadFacing", "dashcamRoadFacing", "dashcamRoadFacing", "dashcamRoadFacing"],
      *         mediaType: "image",
      *         startTime: "2019-06-13T19:08:25Z",
      *         vehicleId: "1234"

package/dist/esm/api/resources/media/client/Client.mjs

@@ -238,7 +238,7 @@ export class MediaClient {
      * @example
      *     await client.media.postMediaRetrieval({
      *         endTime: "2019-06-13T19:08:55Z",
-     *         inputs: ["dashcamRoadFacing", "dashcamRoadFacing", "dashcamRoadFacing"],
+     *         inputs: ["dashcamRoadFacing", "dashcamRoadFacing", "dashcamRoadFacing", "dashcamRoadFacing"],
      *         mediaType: "image",
      *         startTime: "2019-06-13T19:08:25Z",
      *         vehicleId: "1234"

package/dist/esm/api/resources/media/client/requests/MediaRetrievalPostMediaRetrievalRequestBody.d.mts

@@ -2,7 +2,7 @@
  * @example
  *     {
  *         endTime: "2019-06-13T19:08:55Z",
- *         inputs: ["dashcamRoadFacing", "dashcamRoadFacing", "dashcamRoadFacing"],
+ *         inputs: ["dashcamRoadFacing", "dashcamRoadFacing", "dashcamRoadFacing", "dashcamRoadFacing"],
  *         mediaType: "image",
  *         startTime: "2019-06-13T19:08:25Z",
  *         vehicleId: "1234"

package/dist/esm/api/resources/readings/client/requests/GetReadingsHistoryRequest.d.mts

@@ -221,9 +221,6 @@ export interface GetReadingsHistoryRequest {
      *
      * * `addressEntry` (Address Entry): Address data from the address entry event
      * * `addressExit` (Address Exit): Address data from the address exit event
-     * * `ag51BatteryStatus` (AG51 Battery Status): Battery status of the AG51 gateway based on temperature-compensated voltage threshold. The threshold varies from 3672mV at -40°C to 4579mV at 60°C. (values: ok | low)
-     * * `ag51BatteryTemperature` (AG51 Battery Temperature): Internal temperature of the AG51 gateway battery in degrees Celsius (celsius)
-     * * `ag51BatteryVoltage` (AG51 Battery Voltage): Total battery voltage of the AG51 gateway (sum of all 3 cells) in volts (volt)
      * * `atisLamp` (Atis Lamp status): Atis lamp on/off status (values: off | on)
      * * `derivedCargoState` (Cargo Status): Indicates if the overall cargo status of the asset is Empty, Partially Empty, Full, or Unknown. (values: unknown | empty | partiallyEmpty | full)
      * * `doorClosedStatus` (Door Closed Status): Status indicating whether a door is closed or open (values: open | closed)
@@ -232,6 +229,9 @@ export interface GetReadingsHistoryRequest {
      * * `environmentMonitorAmbientTemperatureBLEConnection` (Ambient Temperature (BLE Connection)): Air temperature at the environmental monitor device (built-in sensor) via BLE Connection. (celsius)
      * * `environmentMonitorThermistorTemperature` (Thermistor Temperature): Temperature from an external thermistor probe (e.g. cable probe in cargo or reefer). (celsius)
      * * `environmentMonitorThermistorTemperatureBLEConnection` (Thermistor Temperature (BLE Connection)): Temperature from an external thermistor probe (e.g. cable probe in cargo or reefer) via BLE Connection. (celsius)
+     * * `gatewayBatteryStatus` (Gateway Battery Status): Battery status of the gateway based on temperature-compensated voltage threshold. The threshold varies from 3672mV at -40°C to 4579mV at 60°C. (values: ok | low)
+     * * `gatewayBatteryTemperature` (Gateway Battery Temperature): Internal temperature of the gateway battery in degrees Celsius (celsius)
+     * * `gatewayBatteryVoltage` (Gateway Battery Voltage): Total battery voltage of the gateway (sum of all 3 cells) in volts (volt)
      * * `trailerMovingWithoutPower` (Trailer Moving Without Power): Trailer moving without power status (values: off | on)
      * * `validBrakeScore` (Braking Performance Value): Percent score representing trailer braking effectiveness using regression analysis over the past 90 days, guaranteed to have under 3% margin of error. (percent)
      * * `widgetBatteryVoltage` (Widget Battery Voltage): Battery voltage level of the widget sensor in millivolts (volt)

package/dist/esm/api/resources/readings/client/requests/GetReadingsSnapshotRequest.d.mts

@@ -221,9 +221,6 @@ export interface GetReadingsSnapshotRequest {
      *
      * * `addressEntry` (Address Entry): Address data from the address entry event
      * * `addressExit` (Address Exit): Address data from the address exit event
-     * * `ag51BatteryStatus` (AG51 Battery Status): Battery status of the AG51 gateway based on temperature-compensated voltage threshold. The threshold varies from 3672mV at -40°C to 4579mV at 60°C. (values: ok | low)
-     * * `ag51BatteryTemperature` (AG51 Battery Temperature): Internal temperature of the AG51 gateway battery in degrees Celsius (celsius)
-     * * `ag51BatteryVoltage` (AG51 Battery Voltage): Total battery voltage of the AG51 gateway (sum of all 3 cells) in volts (volt)
      * * `atisLamp` (Atis Lamp status): Atis lamp on/off status (values: off | on)
      * * `derivedCargoState` (Cargo Status): Indicates if the overall cargo status of the asset is Empty, Partially Empty, Full, or Unknown. (values: unknown | empty | partiallyEmpty | full)
      * * `doorClosedStatus` (Door Closed Status): Status indicating whether a door is closed or open (values: open | closed)
@@ -232,6 +229,9 @@ export interface GetReadingsSnapshotRequest {
      * * `environmentMonitorAmbientTemperatureBLEConnection` (Ambient Temperature (BLE Connection)): Air temperature at the environmental monitor device (built-in sensor) via BLE Connection. (celsius)
      * * `environmentMonitorThermistorTemperature` (Thermistor Temperature): Temperature from an external thermistor probe (e.g. cable probe in cargo or reefer). (celsius)
      * * `environmentMonitorThermistorTemperatureBLEConnection` (Thermistor Temperature (BLE Connection)): Temperature from an external thermistor probe (e.g. cable probe in cargo or reefer) via BLE Connection. (celsius)
+     * * `gatewayBatteryStatus` (Gateway Battery Status): Battery status of the gateway based on temperature-compensated voltage threshold. The threshold varies from 3672mV at -40°C to 4579mV at 60°C. (values: ok | low)
+     * * `gatewayBatteryTemperature` (Gateway Battery Temperature): Internal temperature of the gateway battery in degrees Celsius (celsius)
+     * * `gatewayBatteryVoltage` (Gateway Battery Voltage): Total battery voltage of the gateway (sum of all 3 cells) in volts (volt)
      * * `trailerMovingWithoutPower` (Trailer Moving Without Power): Trailer moving without power status (values: off | on)
      * * `validBrakeScore` (Braking Performance Value): Percent score representing trailer braking effectiveness using regression analysis over the past 90 days, guaranteed to have under 3% margin of error. (percent)
      * * `widgetBatteryVoltage` (Widget Battery Voltage): Battery voltage level of the widget sensor in millivolts (volt)

package/dist/esm/api/types/BleAssetTagDetailsResponseResponseBody.d.mts

@@ -0,0 +1,19 @@
+/**
+ * BLE asset tag-specific health metadata details.
+ */
+export interface BleAssetTagDetailsResponseResponseBody {
+    /** The BLE asset tag's battery state.  Valid values: `critical`, `low`, `ok`, `unknown` */
+    batteryState?: BleAssetTagDetailsResponseResponseBody.BatteryState | undefined;
+    /** The timestamp when the BLE asset tag was last detected by a gateway in the Samsara network, in RFC 3339 format. */
+    lastCheckInTime?: string | undefined;
+}
+export declare namespace BleAssetTagDetailsResponseResponseBody {
+    /** The BLE asset tag's battery state.  Valid values: `critical`, `low`, `ok`, `unknown` */
+    const BatteryState: {
+        readonly Critical: "critical";
+        readonly Low: "low";
+        readonly Ok: "ok";
+        readonly Unknown: "unknown";
+    };
+    type BatteryState = (typeof BatteryState)[keyof typeof BatteryState];
+}

package/dist/esm/api/types/BleAssetTagDetailsResponseResponseBody.mjs

@@ -0,0 +1,11 @@
+// This file was auto-generated by Fern from our API Definition.
+export var BleAssetTagDetailsResponseResponseBody;
+(function (BleAssetTagDetailsResponseResponseBody) {
+    /** The BLE asset tag's battery state.  Valid values: `critical`, `low`, `ok`, `unknown` */
+    BleAssetTagDetailsResponseResponseBody.BatteryState = {
+        Critical: "critical",
+        Low: "low",
+        Ok: "ok",
+        Unknown: "unknown",
+    };
+})(BleAssetTagDetailsResponseResponseBody || (BleAssetTagDetailsResponseResponseBody = {}));

package/dist/esm/api/types/CameraConnectorDetailsResponseResponseBody.d.mts

@@ -0,0 +1,11 @@
+/**
+ * Camera connector-specific health metadata details.
+ */
+export interface CameraConnectorDetailsResponseResponseBody {
+    /** The timestamp when the gateway was last connected to the vehicle, in RFC 3339 format. */
+    gatewayLastConnectedTime?: string | undefined;
+    /** The percentage of successful recording time during the time when the vehicle is on an active trip over the past 50 hours, in percentage points. */
+    lastFiftyHoursUptimePercentage?: number | undefined;
+    /** The serial number of the vehicle gateway that the camera connector is connected to. */
+    vehicleGatewaySerial?: string | undefined;
+}

package/dist/esm/api/types/CameraConnectorDetailsResponseResponseBody.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/HealthDetailsResponseResponseBody.d.mts

@@ -3,6 +3,8 @@ import type * as Samsara from "../index.mjs";
  * Detailed health related metadata for the device.
  */
 export interface HealthDetailsResponseResponseBody {
+    bleAssetTagDetails?: Samsara.BleAssetTagDetailsResponseResponseBody | undefined;
+    cameraConnectorDetails?: Samsara.CameraConnectorDetailsResponseResponseBody | undefined;
     cameraDetails?: Samsara.CameraDetailsResponseResponseBody | undefined;
     gatewayDetails?: Samsara.GatewayDetailsResponseResponseBody | undefined;
 }

package/dist/esm/api/types/TrailerStatsObjectResponseBody.d.mts

@@ -5,6 +5,8 @@ import type * as Samsara from "../index.mjs";
 export interface TrailerStatsObjectResponseBody {
     /** A list of engine state points. */
     carrierReeferState?: Samsara.TrailerStatReeferStateWithDecorationsTypeResponseBody[] | undefined;
+    /** A map of external ids */
+    externalIds?: Record<string, string> | undefined;
     /** A list of GPS points. */
     gps?: Samsara.TrailerStatGpsWithDecorationsTypeResponseBody[] | undefined;
     /** A list of odometer points. */

package/dist/esm/api/types/TrailerStatsSnapshotObjectResponseBody.d.mts

@@ -4,6 +4,8 @@ import type * as Samsara from "../index.mjs";
  */
 export interface TrailerStatsSnapshotObjectResponseBody {
     carrierReeferState?: Samsara.TrailerStatReeferStateTypeResponseBody | undefined;
+    /** A map of external ids */
+    externalIds?: Record<string, string> | undefined;
     gps?: Samsara.TrailerStatGpsTypeResponseBody | undefined;
     gpsOdometerMeters?: Samsara.TrailerStatGpsOdometerMetersTypeResponseBody | undefined;
     /** ID of the trailer. */

package/dist/esm/api/types/index.d.mts

@@ -233,6 +233,8 @@ export * from "./BaseRouteResponseObjectResponseBody.mjs";
 export * from "./BehaviorCountDetailsRequestBody.mjs";
 export * from "./BehaviorCountDetailsResponseBody.mjs";
 export * from "./BehaviorResponseBody.mjs";
+export * from "./BleAssetTagDetailsResponseResponseBody.mjs";
+export * from "./CameraConnectorDetailsResponseResponseBody.mjs";
 export * from "./CameraConnectorDisconectedResponseBody.mjs";
 export * from "./CameraDetailsResponseResponseBody.mjs";
 export * from "./CameraSerial.mjs";

package/dist/esm/api/types/index.mjs

@@ -233,6 +233,8 @@ export * from "./BaseRouteResponseObjectResponseBody.mjs";
 export * from "./BehaviorCountDetailsRequestBody.mjs";
 export * from "./BehaviorCountDetailsResponseBody.mjs";
 export * from "./BehaviorResponseBody.mjs";
+export * from "./BleAssetTagDetailsResponseResponseBody.mjs";
+export * from "./CameraConnectorDetailsResponseResponseBody.mjs";
 export * from "./CameraConnectorDisconectedResponseBody.mjs";
 export * from "./CameraDetailsResponseResponseBody.mjs";
 export * from "./CameraSerial.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "13.29.0";
+export declare const SDK_VERSION = "13.31.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "13.29.0";
+export const SDK_VERSION = "13.31.0";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@samsarahq/samsara",
-    "version": "13.29.0",
+    "version": "13.31.0",
     "private": false,
     "repository": {
         "type": "git",

package/reference.md

@@ -6528,7 +6528,7 @@ To use this endpoint, select **Write Safety Events & Scores** under the Safety &
 
 ```typescript
 await client.betaApIs.patchSafetyEventsV2Batch({
-    safetyEventIds: ["bb2ff5ab-30ad-49ec-9d2d-55ec30bbf590", "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"]
 });
 
 ```
@@ -8273,7 +8273,7 @@ To use this endpoint, select **Write Media Retrieval** under the Safety & Camera
 ```typescript
 await client.media.postMediaRetrieval({
     endTime: "2019-06-13T19:08:55Z",
-    inputs: ["dashcamRoadFacing", "dashcamRoadFacing", "dashcamRoadFacing"],
+    inputs: ["dashcamRoadFacing", "dashcamRoadFacing", "dashcamRoadFacing", "dashcamRoadFacing"],
     mediaType: "image",
     startTime: "2019-06-13T19:08:25Z",
     vehicleId: "1234"