@samsarahq/samsara 11.2.0 → 11.4.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": "11.2.0",
-        "User-Agent": "@samsarahq/samsara/11.2.0",
+        "X-Fern-SDK-Version": "11.4.0",
+        "User-Agent": "@samsarahq/samsara/11.4.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/Client.js

@@ -96,7 +96,7 @@ class AssetsClient {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-                const { type: type_, after, updatedAfterTime, includeExternalIds, includeTags, tagIds, parentTagIds, ids, attributeValueIds, attributes, } = request;
+                const { type: type_, after, updatedAfterTime, includeExternalIds, includeTags, tagIds, parentTagIds, ids, externalIds, attributeValueIds, attributes, } = request;
                 const _queryParams = {
                     type: type_ != null ? type_ : undefined,
                     after,
@@ -106,6 +106,7 @@ class AssetsClient {
                     tagIds,
                     parentTagIds,
                     ids,
+                    externalIds,
                     attributeValueIds,
                     attributes,
                 };

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

@@ -1,8 +1,11 @@
+import type * as Samsara from "../../../../index.js";
 /**
  * @example
  *     {}
  */
 export interface AssetsCreateAssetRequestBody {
+    /** A list of attributes to assign to the asset. */
+    attributes?: Samsara.GoaAttributeTinyRequestBody[];
     /** A map of external ids */
     externalIds?: Record<string, string>;
     /** The license plate of the asset. */
@@ -21,6 +24,8 @@ 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. */
+    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;
     /** The unique 17-digit VIN (Vehicle Identification Number) or PIN (Product Identification Number) of the asset. */

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

@@ -20,6 +20,8 @@ export interface ListAssetsRequest {
     parentTagIds?: string;
     /** A filter on the data based on this comma-separated list of asset IDs and External IDs. */
     ids?: string | string[];
+    /** A filter on the data based on this comma-separated list of external IDs. Example: `externalIds=maintenanceId:250020,vin:1HGBH41JXMN109186` */
+    externalIds?: string | string[];
     /** A filter on the data based on this comma-separated list of attribute value IDs. Only entities associated with ALL of the referenced values will be returned (i.e. the intersection of the sets of entities with each value). Example: `attributeValueIds=076efac2-83b5-47aa-ba36-18428436dcac,6707b3f0-23b9-4fe3-b7be-11be34aea544` */
     attributeValueIds?: string;
     /** A filter on the data to return entities within given range query (only for numeric and date attributes) separated by a comma. Only entities meeting all the conditions will be returned. At least one bound must be provided. Example: `attributes=Length:range(8,)&attributes=Length:range(10,20)&attributes=Date:range(2025-01-01,2025-01-31)` */

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

@@ -1323,7 +1323,6 @@ export declare class BetaApIsClient {
      * @example
      *     await client.betaApIs.postReadings({
      *         data: [{
-     *                 entityId: "123451234512345",
      *                 entityType: "asset",
      *                 happenedAtTime: "2023-10-27T10:00:00Z",
      *                 readingId: "airInletPressure",

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

@@ -3826,7 +3826,6 @@ class BetaApIsClient {
      * @example
      *     await client.betaApIs.postReadings({
      *         data: [{
-     *                 entityId: "123451234512345",
      *                 entityType: "asset",
      *                 happenedAtTime: "2023-10-27T10:00:00Z",
      *                 readingId: "airInletPressure",

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

@@ -3,7 +3,6 @@ import type * as Samsara from "../../../../index.js";
  * @example
  *     {
  *         data: [{
- *                 entityId: "123451234512345",
  *                 entityType: "asset",
  *                 happenedAtTime: "2023-10-27T10:00:00Z",
  *                 readingId: "airInletPressure",

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"],
      *         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"],
      *         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"],
  *         mediaType: "image",
  *         startTime: "2019-06-13T19:08:25Z",
  *         vehicleId: "1234"

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

@@ -2,10 +2,12 @@
  * A single reading data point to be created.
  */
 export interface ReadingDatapointRequestBody {
-    /** Samsara entity ID. In case of an asset, it’s the assetId. If the asset is not yet present in the system, it is required to create a new one via the /assets endpoint. */
-    entityId: string;
+    /** Samsara entity ID. Required if externalId is not provided. In case of an asset, it’s the assetId. If the asset is not yet present in the system, it is required to create a new one via the /assets endpoint. */
+    entityId?: string | undefined;
     /** The type of the entity (e.g., asset).  Valid values: `asset` */
     entityType: ReadingDatapointRequestBody.EntityType;
+    /** An external ID in key:value format. Required if entityId is not provided. Use this to reference an asset by its external ID instead of the Samsara entity ID. */
+    externalId?: string | undefined;
     /** The timestamp of when the reading happened in RFC 3339 format. happenedAtTime must not be older than the last known reading for the same series. */
     happenedAtTime: string;
     /** The ID of the reading, you can get it from the /readings/definitions endpoint. */

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "11.2.0";
+export declare const SDK_VERSION = "11.4.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 = "11.2.0";
+exports.SDK_VERSION = "11.4.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": "11.2.0",
-        "User-Agent": "@samsarahq/samsara/11.2.0",
+        "X-Fern-SDK-Version": "11.4.0",
+        "User-Agent": "@samsarahq/samsara/11.4.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/Client.mjs

@@ -60,7 +60,7 @@ export class AssetsClient {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-                const { type: type_, after, updatedAfterTime, includeExternalIds, includeTags, tagIds, parentTagIds, ids, attributeValueIds, attributes, } = request;
+                const { type: type_, after, updatedAfterTime, includeExternalIds, includeTags, tagIds, parentTagIds, ids, externalIds, attributeValueIds, attributes, } = request;
                 const _queryParams = {
                     type: type_ != null ? type_ : undefined,
                     after,
@@ -70,6 +70,7 @@ export class AssetsClient {
                     tagIds,
                     parentTagIds,
                     ids,
+                    externalIds,
                     attributeValueIds,
                     attributes,
                 };

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

@@ -1,8 +1,11 @@
+import type * as Samsara from "../../../../index.mjs";
 /**
  * @example
  *     {}
  */
 export interface AssetsCreateAssetRequestBody {
+    /** A list of attributes to assign to the asset. */
+    attributes?: Samsara.GoaAttributeTinyRequestBody[];
     /** A map of external ids */
     externalIds?: Record<string, string>;
     /** The license plate of the asset. */
@@ -21,6 +24,8 @@ 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. */
+    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;
     /** The unique 17-digit VIN (Vehicle Identification Number) or PIN (Product Identification Number) of the asset. */

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

@@ -20,6 +20,8 @@ export interface ListAssetsRequest {
     parentTagIds?: string;
     /** A filter on the data based on this comma-separated list of asset IDs and External IDs. */
     ids?: string | string[];
+    /** A filter on the data based on this comma-separated list of external IDs. Example: `externalIds=maintenanceId:250020,vin:1HGBH41JXMN109186` */
+    externalIds?: string | string[];
     /** A filter on the data based on this comma-separated list of attribute value IDs. Only entities associated with ALL of the referenced values will be returned (i.e. the intersection of the sets of entities with each value). Example: `attributeValueIds=076efac2-83b5-47aa-ba36-18428436dcac,6707b3f0-23b9-4fe3-b7be-11be34aea544` */
     attributeValueIds?: string;
     /** A filter on the data to return entities within given range query (only for numeric and date attributes) separated by a comma. Only entities meeting all the conditions will be returned. At least one bound must be provided. Example: `attributes=Length:range(8,)&attributes=Length:range(10,20)&attributes=Date:range(2025-01-01,2025-01-31)` */

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

@@ -1323,7 +1323,6 @@ export declare class BetaApIsClient {
      * @example
      *     await client.betaApIs.postReadings({
      *         data: [{
-     *                 entityId: "123451234512345",
      *                 entityType: "asset",
      *                 happenedAtTime: "2023-10-27T10:00:00Z",
      *                 readingId: "airInletPressure",

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

@@ -3790,7 +3790,6 @@ export class BetaApIsClient {
      * @example
      *     await client.betaApIs.postReadings({
      *         data: [{
-     *                 entityId: "123451234512345",
      *                 entityType: "asset",
      *                 happenedAtTime: "2023-10-27T10:00:00Z",
      *                 readingId: "airInletPressure",

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

@@ -3,7 +3,6 @@ import type * as Samsara from "../../../../index.mjs";
  * @example
  *     {
  *         data: [{
- *                 entityId: "123451234512345",
  *                 entityType: "asset",
  *                 happenedAtTime: "2023-10-27T10:00:00Z",
  *                 readingId: "airInletPressure",

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"],
      *         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"],
      *         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"],
  *         mediaType: "image",
  *         startTime: "2019-06-13T19:08:25Z",
  *         vehicleId: "1234"

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

@@ -2,10 +2,12 @@
  * A single reading data point to be created.
  */
 export interface ReadingDatapointRequestBody {
-    /** Samsara entity ID. In case of an asset, it’s the assetId. If the asset is not yet present in the system, it is required to create a new one via the /assets endpoint. */
-    entityId: string;
+    /** Samsara entity ID. Required if externalId is not provided. In case of an asset, it’s the assetId. If the asset is not yet present in the system, it is required to create a new one via the /assets endpoint. */
+    entityId?: string | undefined;
     /** The type of the entity (e.g., asset).  Valid values: `asset` */
     entityType: ReadingDatapointRequestBody.EntityType;
+    /** An external ID in key:value format. Required if entityId is not provided. Use this to reference an asset by its external ID instead of the Samsara entity ID. */
+    externalId?: string | undefined;
     /** The timestamp of when the reading happened in RFC 3339 format. happenedAtTime must not be older than the last known reading for the same series. */
     happenedAtTime: string;
     /** The ID of the reading, you can get it from the /readings/definitions endpoint. */

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "11.2.0";
+export declare const SDK_VERSION = "11.4.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "11.2.0";
+export const SDK_VERSION = "11.4.0";

package/package.json

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

package/reference.md

@@ -4577,7 +4577,6 @@ To use this endpoint, select **Write Readings** under the Closed Beta category w
 ```typescript
 await client.betaApIs.postReadings({
     data: [{
-            entityId: "123451234512345",
             entityType: "asset",
             happenedAtTime: "2023-10-27T10:00:00Z",
             readingId: "airInletPressure",
@@ -6894,7 +6893,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"],
     mediaType: "image",
     startTime: "2019-06-13T19:08:25Z",
     vehicleId: "1234"