@samsarahq/samsara 13.6.0 → 13.8.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.6.0",
-        "User-Agent": "@samsarahq/samsara/13.6.0",
+        "X-Fern-SDK-Version": "13.8.0",
+        "User-Agent": "@samsarahq/samsara/13.8.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
         "X-Samsara-Version": (_a = options === null || options === void 0 ? void 0 : options.version) !== null && _a !== void 0 ? _a : "2025-06-11",

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

@@ -1241,7 +1241,7 @@ export declare class BetaApIsClient {
     deleteHubRouteTemplate(request: Samsara.DeleteHubRouteTemplateRequest, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<void>;
     private __deleteHubRouteTemplate;
     /**
-     * Returns places for the authorized organization. Supports cursor pagination or batch fetch by Samsara place ids via `placeIds`.
+     * Returns places for the authorized organization. Supports cursor pagination or batch fetch by Samsara place ids via `placeIds` or by external ids via `externalIds` (mutually exclusive).
      *
      *  <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>).
      *
@@ -1330,7 +1330,7 @@ export declare class BetaApIsClient {
     deletePlace(request: Samsara.DeletePlaceRequest, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<void>;
     private __deletePlace;
     /**
-     * Updates a place. Query parameter `placeId` (Samsara id) is required. Optional `externalId` (key:value) is reserved for a future release and must not be combined with `placeId`. Only fields present in the JSON body are changed; omit a field to leave it unchanged.
+     * Updates a place. Provide exactly one of query parameter `placeId` (Samsara id) or `externalId` (key:value). Only fields present in the JSON body are changed; omit a field to leave it unchanged.
      *
      *  <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>).
      *
@@ -1353,11 +1353,9 @@ export declare class BetaApIsClient {
      * @throws {@link Samsara.GatewayTimeoutError}
      *
      * @example
-     *     await client.betaApIs.patchPlace({
-     *         placeId: 1000000
-     *     })
+     *     await client.betaApIs.patchPlace()
      */
-    patchPlace(request: Samsara.PlacesPatchPlaceRequestBody, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.PlacesPatchPlaceResponseBody>;
+    patchPlace(request?: Samsara.PlacesPatchPlaceRequestBody, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.PlacesPatchPlaceResponseBody>;
     private __patchPlace;
     /**
      * List all preferred fuel stations for your organization.
@@ -1774,7 +1772,33 @@ export declare class BetaApIsClient {
     /**
      * Ingest new readings. This endpoint allows the ingestion of batches of readings.
      *
-     * Ingesting readings is only supported for assets created using the POST /assets API endpoint with readingsIngestionEnabled set to true. To see a full list of readings available for ingestion use the GET readings definitions API. When ingesting location data, the readingID 'location' must be used and the value object must contain at least the following fields: 'speed', 'latitude', 'longitude'.
+     * Ingesting readings is only supported for assets created using the POST /assets API endpoint with readingsIngestionEnabled set to true. To see a full list of readings available for ingestion use the GET readings definitions API.
+     *
+     *
+     * Readings that currently support ingestion (by category):
+     *
+     *
+     * <details>
+     * <summary><strong>ingestible</strong></summary>
+     *
+     * * `batteryVoltage`
+     * * `coolantTemp`
+     * * `ecuFuelLevelMillipercent`
+     * * `engineHours`
+     * * `engineRpm`
+     * * `engineState` (values: off | running | idling)
+     * * `faultCodesJ1939`
+     * * `faultCodesOBDII`
+     * * `fuelLevelPerc`
+     * * `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'.
      *
      * Related guide: [Readings](https://developers.samsara.com/docs/readings).
      *

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

@@ -3686,7 +3686,7 @@ class BetaApIsClient {
         });
     }
     /**
-     * Returns places for the authorized organization. Supports cursor pagination or batch fetch by Samsara place ids via `placeIds`.
+     * Returns places for the authorized organization. Supports cursor pagination or batch fetch by Samsara place ids via `placeIds` or by external ids via `externalIds` (mutually exclusive).
      *
      *  <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>).
      *
@@ -3948,7 +3948,7 @@ class BetaApIsClient {
         });
     }
     /**
-     * Updates a place. Query parameter `placeId` (Samsara id) is required. Optional `externalId` (key:value) is reserved for a future release and must not be combined with `placeId`. Only fields present in the JSON body are changed; omit a field to leave it unchanged.
+     * Updates a place. Provide exactly one of query parameter `placeId` (Samsara id) or `externalId` (key:value). Only fields present in the JSON body are changed; omit a field to leave it unchanged.
      *
      *  <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>).
      *
@@ -3971,15 +3971,13 @@ class BetaApIsClient {
      * @throws {@link Samsara.GatewayTimeoutError}
      *
      * @example
-     *     await client.betaApIs.patchPlace({
-     *         placeId: 1000000
-     *     })
+     *     await client.betaApIs.patchPlace()
      */
-    patchPlace(request, requestOptions) {
+    patchPlace(request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__patchPlace(request, requestOptions));
     }
-    __patchPlace(request, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
+    __patchPlace() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
             const { placeId, externalId } = request, _body = __rest(request, ["placeId", "externalId"]);
             const _queryParams = {
@@ -5202,7 +5200,33 @@ class BetaApIsClient {
     /**
      * Ingest new readings. This endpoint allows the ingestion of batches of readings.
      *
-     * Ingesting readings is only supported for assets created using the POST /assets API endpoint with readingsIngestionEnabled set to true. To see a full list of readings available for ingestion use the GET readings definitions API. When ingesting location data, the readingID 'location' must be used and the value object must contain at least the following fields: 'speed', 'latitude', 'longitude'.
+     * Ingesting readings is only supported for assets created using the POST /assets API endpoint with readingsIngestionEnabled set to true. To see a full list of readings available for ingestion use the GET readings definitions API.
+     *
+     *
+     * Readings that currently support ingestion (by category):
+     *
+     *
+     * <details>
+     * <summary><strong>ingestible</strong></summary>
+     *
+     * * `batteryVoltage`
+     * * `coolantTemp`
+     * * `ecuFuelLevelMillipercent`
+     * * `engineHours`
+     * * `engineRpm`
+     * * `engineState` (values: off | running | idling)
+     * * `faultCodesJ1939`
+     * * `faultCodesOBDII`
+     * * `fuelLevelPerc`
+     * * `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'.
      *
      * Related guide: [Readings](https://developers.samsara.com/docs/readings).
      *

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

@@ -7,9 +7,9 @@ export interface GetPlacesRequest {
     after?: string;
     /** The limit for how many objects will be in the response. Default and max for this value is 512 objects. */
     limit?: number;
-    /** Comma-separated Samsara place IDs for batch lookup (max 100). When set, list filters and cursor pagination are ignored. External id tokens (key:value) are not supported in this version. */
+    /** Comma-separated Samsara place IDs for batch lookup (max 100). When set, list filters and cursor pagination are ignored. Mutually exclusive with `externalIds`. */
     placeIds?: string;
-    /** Reserved. Batch lookup by external IDs is not implemented in this API version. */
+    /** Comma-separated external ID tokens (`key:value`) for batch lookup (max 100). When set, list filters and cursor pagination are ignored. Mutually exclusive with `placeIds`. */
     externalIds?: string;
     /** When true, expands tag objects on each place. Defaults to false. */
     includeTags?: boolean;

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

@@ -1,14 +1,12 @@
 import type * as Samsara from "../../../../index.js";
 /**
  * @example
- *     {
- *         placeId: 1000000
- *     }
+ *     {}
  */
 export interface PlacesPatchPlaceRequestBody {
-    /** Samsara place id to update (required). Do not send `externalId` in the same request. */
-    placeId: number;
-    /** External id token in `key:value` form (e.g. crmId:warehouse-east). Mutually exclusive with `placeId`. Batch lookup by external id is not implemented for this endpoint yet; callers should use `placeId` until supported. */
+    /** Samsara place id to update. Mutually exclusive with `externalId`; provide exactly one. */
+    placeId?: number;
+    /** External id token in `key:value` form (e.g. crmId:warehouse-east). Mutually exclusive with `placeId`; provide exactly one. */
     externalId?: string;
     /** Single-line address string. */
     address?: string;
@@ -21,6 +19,8 @@ export interface PlacesPatchPlaceRequestBody {
     hubLocations?: Samsara.PatchPlaceHubLocationsBodyRequestBody;
     /** 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. */
@@ -30,7 +30,7 @@ export interface PlacesPatchPlaceRequestBody {
     navigation?: Samsara.PostPlaceNavigationInputRequestBody;
     /** Notes. */
     notes?: string;
-    /** Unsupported on patch; when provided this API returns InvalidArgument. */
+    /** 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. */
     placeTypes?: string[];
     /** Circle radius in meters; use with latitude and longitude. */
     radiusMeters?: number;

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

@@ -19,6 +19,8 @@ export interface PlacesPostPlaceRequestBody {
     hubLocations?: Samsara.PatchPlaceHubLocationUpsertBodyRequestBody[];
     /** 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. */
@@ -28,7 +30,7 @@ export interface PlacesPostPlaceRequestBody {
     navigation?: Samsara.PostPlaceNavigationInputRequestBody;
     /** Optional notes. */
     notes?: string;
-    /** Unsupported on create; when provided this API returns InvalidArgument. */
+    /** 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. */
     placeTypes?: string[];
     /** Circle radius in meters; requires latitude and longitude. Must be at least 1 when set. */
     radiusMeters?: number;

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

@@ -1,3 +1,4 @@
+import type * as Samsara from "../index.js";
 /**
  * Hub location upsert entry for PATCH /places.
  */
@@ -16,4 +17,14 @@ export interface PatchPlaceHubLocationUpsertBodyRequestBody {
     isIgnoreOrderServiceTimeEnabled?: boolean | undefined;
     /** Stop position preference: unspecified, any, first, or last. */
     locationPositionType?: string | undefined;
+    /** Route priority from 1 (lowest) to 5 (highest). */
+    locationPriority?: number | undefined;
+    orderServiceTime?: Samsara.PlaceHubLocationOrderServiceTimeInputRequestBody | undefined;
+    /** Required planner skills for this hub location. */
+    requiredSkills?: Samsara.PlaceHubLocationRequiredSkillInputRequestBody[] | undefined;
+    serviceTime?: Samsara.PlaceHubLocationServiceTimeInputRequestBody | undefined;
+    /** Recurring local-time service windows for this hub location. */
+    serviceWindows?: Samsara.PlaceHubLocationServiceWindowInputRequestBody[] | undefined;
+    /** Default instructions for drivers at this hub location. */
+    standardDriverInstructions?: string | undefined;
 }

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

@@ -0,0 +1,11 @@
+/**
+ * Per-capacity order service time entry for a hub location row.
+ */
+export interface PlaceHubLocationCapacityServiceTimeInputRequestBody {
+    /** Capacity UUID. */
+    capacityId: string;
+    /** Service time in seconds. */
+    serviceTimeSeconds: number;
+    /** Additional service time per quantity unit. */
+    serviceTimeSecondsPerQuantityUnit: number;
+}

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

@@ -0,0 +1,22 @@
+import type * as Samsara from "../index.js";
+/**
+ * Order service time configuration for a hub location row.
+ */
+export interface PlaceHubLocationOrderServiceTimeInputRequestBody {
+    /** Capacity-based service times for variable mode. */
+    capacityServiceTimes?: Samsara.PlaceHubLocationCapacityServiceTimeInputRequestBody[] | undefined;
+    /** Fixed order service time in seconds when applicable. */
+    fixedTimeSeconds?: number | undefined;
+    /** Mode: fixed or variable.  Valid values: `fixed`, `variable`, `unknown`, `unspecified` */
+    modeType: PlaceHubLocationOrderServiceTimeInputRequestBody.ModeType;
+}
+export declare namespace PlaceHubLocationOrderServiceTimeInputRequestBody {
+    /** Mode: fixed or variable.  Valid values: `fixed`, `variable`, `unknown`, `unspecified` */
+    const ModeType: {
+        readonly Fixed: "fixed";
+        readonly Variable: "variable";
+        readonly Unknown: "unknown";
+        readonly Unspecified: "unspecified";
+    };
+    type ModeType = (typeof ModeType)[keyof typeof ModeType];
+}

package/dist/cjs/api/types/PlaceHubLocationOrderServiceTimeInputRequestBody.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.PlaceHubLocationOrderServiceTimeInputRequestBody = void 0;
+var PlaceHubLocationOrderServiceTimeInputRequestBody;
+(function (PlaceHubLocationOrderServiceTimeInputRequestBody) {
+    /** Mode: fixed or variable.  Valid values: `fixed`, `variable`, `unknown`, `unspecified` */
+    PlaceHubLocationOrderServiceTimeInputRequestBody.ModeType = {
+        Fixed: "fixed",
+        Variable: "variable",
+        Unknown: "unknown",
+        Unspecified: "unspecified",
+    };
+})(PlaceHubLocationOrderServiceTimeInputRequestBody || (exports.PlaceHubLocationOrderServiceTimeInputRequestBody = PlaceHubLocationOrderServiceTimeInputRequestBody = {}));

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

@@ -0,0 +1,7 @@
+/**
+ * Required planner skill reference for a place hub location row.
+ */
+export interface PlaceHubLocationRequiredSkillInputRequestBody {
+    /** Planner skill UUID. */
+    id: string;
+}

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

@@ -0,0 +1,9 @@
+/**
+ * Additional service time configuration for a hub location row.
+ */
+export interface PlaceHubLocationServiceTimeInputRequestBody {
+    /** Whole minutes of additional service time. */
+    additionalTimeMinutes: number;
+    /** Whether additional service time is enabled. */
+    isEnabled: boolean;
+}

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

@@ -0,0 +1,11 @@
+/**
+ * Recurring service window for a place hub location row.
+ */
+export interface PlaceHubLocationServiceWindowInputRequestBody {
+    /** Days this window applies. */
+    days: string[];
+    /** End time as seconds since local midnight. */
+    endTime: number;
+    /** Start time as seconds since local midnight. */
+    startTime: number;
+}

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

@@ -1878,6 +1878,11 @@ export * from "./PersonDetectedResponseBody.js";
 export * from "./PhotoValueObjectRequestBody.js";
 export * from "./PhotoValueObjectResponseBody.js";
 export * from "./PlaceGeofenceVertexResponseResponseBody.js";
+export * from "./PlaceHubLocationCapacityServiceTimeInputRequestBody.js";
+export * from "./PlaceHubLocationOrderServiceTimeInputRequestBody.js";
+export * from "./PlaceHubLocationRequiredSkillInputRequestBody.js";
+export * from "./PlaceHubLocationServiceTimeInputRequestBody.js";
+export * from "./PlaceHubLocationServiceWindowInputRequestBody.js";
 export * from "./PlaceNavigationLocationResponseResponseBody.js";
 export * from "./PlaceNavigationResponseResponseBody.js";
 export * from "./PlaceResponseObjectResponseBody.js";

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

@@ -1894,6 +1894,11 @@ __exportStar(require("./PersonDetectedResponseBody.js"), exports);
 __exportStar(require("./PhotoValueObjectRequestBody.js"), exports);
 __exportStar(require("./PhotoValueObjectResponseBody.js"), exports);
 __exportStar(require("./PlaceGeofenceVertexResponseResponseBody.js"), exports);
+__exportStar(require("./PlaceHubLocationCapacityServiceTimeInputRequestBody.js"), exports);
+__exportStar(require("./PlaceHubLocationOrderServiceTimeInputRequestBody.js"), exports);
+__exportStar(require("./PlaceHubLocationRequiredSkillInputRequestBody.js"), exports);
+__exportStar(require("./PlaceHubLocationServiceTimeInputRequestBody.js"), exports);
+__exportStar(require("./PlaceHubLocationServiceWindowInputRequestBody.js"), exports);
 __exportStar(require("./PlaceNavigationLocationResponseResponseBody.js"), exports);
 __exportStar(require("./PlaceNavigationResponseResponseBody.js"), exports);
 __exportStar(require("./PlaceResponseObjectResponseBody.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "13.6.0";
+export declare const SDK_VERSION = "13.8.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.6.0";
+exports.SDK_VERSION = "13.8.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.6.0",
-        "User-Agent": "@samsarahq/samsara/13.6.0",
+        "X-Fern-SDK-Version": "13.8.0",
+        "User-Agent": "@samsarahq/samsara/13.8.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/betaApIs/client/Client.d.mts

@@ -1241,7 +1241,7 @@ export declare class BetaApIsClient {
     deleteHubRouteTemplate(request: Samsara.DeleteHubRouteTemplateRequest, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<void>;
     private __deleteHubRouteTemplate;
     /**
-     * Returns places for the authorized organization. Supports cursor pagination or batch fetch by Samsara place ids via `placeIds`.
+     * Returns places for the authorized organization. Supports cursor pagination or batch fetch by Samsara place ids via `placeIds` or by external ids via `externalIds` (mutually exclusive).
      *
      *  <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>).
      *
@@ -1330,7 +1330,7 @@ export declare class BetaApIsClient {
     deletePlace(request: Samsara.DeletePlaceRequest, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<void>;
     private __deletePlace;
     /**
-     * Updates a place. Query parameter `placeId` (Samsara id) is required. Optional `externalId` (key:value) is reserved for a future release and must not be combined with `placeId`. Only fields present in the JSON body are changed; omit a field to leave it unchanged.
+     * Updates a place. Provide exactly one of query parameter `placeId` (Samsara id) or `externalId` (key:value). Only fields present in the JSON body are changed; omit a field to leave it unchanged.
      *
      *  <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>).
      *
@@ -1353,11 +1353,9 @@ export declare class BetaApIsClient {
      * @throws {@link Samsara.GatewayTimeoutError}
      *
      * @example
-     *     await client.betaApIs.patchPlace({
-     *         placeId: 1000000
-     *     })
+     *     await client.betaApIs.patchPlace()
      */
-    patchPlace(request: Samsara.PlacesPatchPlaceRequestBody, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.PlacesPatchPlaceResponseBody>;
+    patchPlace(request?: Samsara.PlacesPatchPlaceRequestBody, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.PlacesPatchPlaceResponseBody>;
     private __patchPlace;
     /**
      * List all preferred fuel stations for your organization.
@@ -1774,7 +1772,33 @@ export declare class BetaApIsClient {
     /**
      * Ingest new readings. This endpoint allows the ingestion of batches of readings.
      *
-     * Ingesting readings is only supported for assets created using the POST /assets API endpoint with readingsIngestionEnabled set to true. To see a full list of readings available for ingestion use the GET readings definitions API. When ingesting location data, the readingID 'location' must be used and the value object must contain at least the following fields: 'speed', 'latitude', 'longitude'.
+     * Ingesting readings is only supported for assets created using the POST /assets API endpoint with readingsIngestionEnabled set to true. To see a full list of readings available for ingestion use the GET readings definitions API.
+     *
+     *
+     * Readings that currently support ingestion (by category):
+     *
+     *
+     * <details>
+     * <summary><strong>ingestible</strong></summary>
+     *
+     * * `batteryVoltage`
+     * * `coolantTemp`
+     * * `ecuFuelLevelMillipercent`
+     * * `engineHours`
+     * * `engineRpm`
+     * * `engineState` (values: off | running | idling)
+     * * `faultCodesJ1939`
+     * * `faultCodesOBDII`
+     * * `fuelLevelPerc`
+     * * `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'.
      *
      * Related guide: [Readings](https://developers.samsara.com/docs/readings).
      *

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

@@ -3650,7 +3650,7 @@ export class BetaApIsClient {
         });
     }
     /**
-     * Returns places for the authorized organization. Supports cursor pagination or batch fetch by Samsara place ids via `placeIds`.
+     * Returns places for the authorized organization. Supports cursor pagination or batch fetch by Samsara place ids via `placeIds` or by external ids via `externalIds` (mutually exclusive).
      *
      *  <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>).
      *
@@ -3912,7 +3912,7 @@ export class BetaApIsClient {
         });
     }
     /**
-     * Updates a place. Query parameter `placeId` (Samsara id) is required. Optional `externalId` (key:value) is reserved for a future release and must not be combined with `placeId`. Only fields present in the JSON body are changed; omit a field to leave it unchanged.
+     * Updates a place. Provide exactly one of query parameter `placeId` (Samsara id) or `externalId` (key:value). Only fields present in the JSON body are changed; omit a field to leave it unchanged.
      *
      *  <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>).
      *
@@ -3935,15 +3935,13 @@ export class BetaApIsClient {
      * @throws {@link Samsara.GatewayTimeoutError}
      *
      * @example
-     *     await client.betaApIs.patchPlace({
-     *         placeId: 1000000
-     *     })
+     *     await client.betaApIs.patchPlace()
      */
-    patchPlace(request, requestOptions) {
+    patchPlace(request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__patchPlace(request, requestOptions));
     }
-    __patchPlace(request, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
+    __patchPlace() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
             const { placeId, externalId } = request, _body = __rest(request, ["placeId", "externalId"]);
             const _queryParams = {
@@ -5166,7 +5164,33 @@ export class BetaApIsClient {
     /**
      * Ingest new readings. This endpoint allows the ingestion of batches of readings.
      *
-     * Ingesting readings is only supported for assets created using the POST /assets API endpoint with readingsIngestionEnabled set to true. To see a full list of readings available for ingestion use the GET readings definitions API. When ingesting location data, the readingID 'location' must be used and the value object must contain at least the following fields: 'speed', 'latitude', 'longitude'.
+     * Ingesting readings is only supported for assets created using the POST /assets API endpoint with readingsIngestionEnabled set to true. To see a full list of readings available for ingestion use the GET readings definitions API.
+     *
+     *
+     * Readings that currently support ingestion (by category):
+     *
+     *
+     * <details>
+     * <summary><strong>ingestible</strong></summary>
+     *
+     * * `batteryVoltage`
+     * * `coolantTemp`
+     * * `ecuFuelLevelMillipercent`
+     * * `engineHours`
+     * * `engineRpm`
+     * * `engineState` (values: off | running | idling)
+     * * `faultCodesJ1939`
+     * * `faultCodesOBDII`
+     * * `fuelLevelPerc`
+     * * `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'.
      *
      * Related guide: [Readings](https://developers.samsara.com/docs/readings).
      *

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

@@ -7,9 +7,9 @@ export interface GetPlacesRequest {
     after?: string;
     /** The limit for how many objects will be in the response. Default and max for this value is 512 objects. */
     limit?: number;
-    /** Comma-separated Samsara place IDs for batch lookup (max 100). When set, list filters and cursor pagination are ignored. External id tokens (key:value) are not supported in this version. */
+    /** Comma-separated Samsara place IDs for batch lookup (max 100). When set, list filters and cursor pagination are ignored. Mutually exclusive with `externalIds`. */
     placeIds?: string;
-    /** Reserved. Batch lookup by external IDs is not implemented in this API version. */
+    /** Comma-separated external ID tokens (`key:value`) for batch lookup (max 100). When set, list filters and cursor pagination are ignored. Mutually exclusive with `placeIds`. */
     externalIds?: string;
     /** When true, expands tag objects on each place. Defaults to false. */
     includeTags?: boolean;

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

@@ -1,14 +1,12 @@
 import type * as Samsara from "../../../../index.mjs";
 /**
  * @example
- *     {
- *         placeId: 1000000
- *     }
+ *     {}
  */
 export interface PlacesPatchPlaceRequestBody {
-    /** Samsara place id to update (required). Do not send `externalId` in the same request. */
-    placeId: number;
-    /** External id token in `key:value` form (e.g. crmId:warehouse-east). Mutually exclusive with `placeId`. Batch lookup by external id is not implemented for this endpoint yet; callers should use `placeId` until supported. */
+    /** Samsara place id to update. Mutually exclusive with `externalId`; provide exactly one. */
+    placeId?: number;
+    /** External id token in `key:value` form (e.g. crmId:warehouse-east). Mutually exclusive with `placeId`; provide exactly one. */
     externalId?: string;
     /** Single-line address string. */
     address?: string;
@@ -21,6 +19,8 @@ export interface PlacesPatchPlaceRequestBody {
     hubLocations?: Samsara.PatchPlaceHubLocationsBodyRequestBody;
     /** 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. */
@@ -30,7 +30,7 @@ export interface PlacesPatchPlaceRequestBody {
     navigation?: Samsara.PostPlaceNavigationInputRequestBody;
     /** Notes. */
     notes?: string;
-    /** Unsupported on patch; when provided this API returns InvalidArgument. */
+    /** 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. */
     placeTypes?: string[];
     /** Circle radius in meters; use with latitude and longitude. */
     radiusMeters?: number;

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

@@ -19,6 +19,8 @@ export interface PlacesPostPlaceRequestBody {
     hubLocations?: Samsara.PatchPlaceHubLocationUpsertBodyRequestBody[];
     /** 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. */
@@ -28,7 +30,7 @@ export interface PlacesPostPlaceRequestBody {
     navigation?: Samsara.PostPlaceNavigationInputRequestBody;
     /** Optional notes. */
     notes?: string;
-    /** Unsupported on create; when provided this API returns InvalidArgument. */
+    /** 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. */
     placeTypes?: string[];
     /** Circle radius in meters; requires latitude and longitude. Must be at least 1 when set. */
     radiusMeters?: number;

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

@@ -1,3 +1,4 @@
+import type * as Samsara from "../index.mjs";
 /**
  * Hub location upsert entry for PATCH /places.
  */
@@ -16,4 +17,14 @@ export interface PatchPlaceHubLocationUpsertBodyRequestBody {
     isIgnoreOrderServiceTimeEnabled?: boolean | undefined;
     /** Stop position preference: unspecified, any, first, or last. */
     locationPositionType?: string | undefined;
+    /** Route priority from 1 (lowest) to 5 (highest). */
+    locationPriority?: number | undefined;
+    orderServiceTime?: Samsara.PlaceHubLocationOrderServiceTimeInputRequestBody | undefined;
+    /** Required planner skills for this hub location. */
+    requiredSkills?: Samsara.PlaceHubLocationRequiredSkillInputRequestBody[] | undefined;
+    serviceTime?: Samsara.PlaceHubLocationServiceTimeInputRequestBody | undefined;
+    /** Recurring local-time service windows for this hub location. */
+    serviceWindows?: Samsara.PlaceHubLocationServiceWindowInputRequestBody[] | undefined;
+    /** Default instructions for drivers at this hub location. */
+    standardDriverInstructions?: string | undefined;
 }

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

@@ -0,0 +1,11 @@
+/**
+ * Per-capacity order service time entry for a hub location row.
+ */
+export interface PlaceHubLocationCapacityServiceTimeInputRequestBody {
+    /** Capacity UUID. */
+    capacityId: string;
+    /** Service time in seconds. */
+    serviceTimeSeconds: number;
+    /** Additional service time per quantity unit. */
+    serviceTimeSecondsPerQuantityUnit: number;
+}

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

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

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

@@ -0,0 +1,22 @@
+import type * as Samsara from "../index.mjs";
+/**
+ * Order service time configuration for a hub location row.
+ */
+export interface PlaceHubLocationOrderServiceTimeInputRequestBody {
+    /** Capacity-based service times for variable mode. */
+    capacityServiceTimes?: Samsara.PlaceHubLocationCapacityServiceTimeInputRequestBody[] | undefined;
+    /** Fixed order service time in seconds when applicable. */
+    fixedTimeSeconds?: number | undefined;
+    /** Mode: fixed or variable.  Valid values: `fixed`, `variable`, `unknown`, `unspecified` */
+    modeType: PlaceHubLocationOrderServiceTimeInputRequestBody.ModeType;
+}
+export declare namespace PlaceHubLocationOrderServiceTimeInputRequestBody {
+    /** Mode: fixed or variable.  Valid values: `fixed`, `variable`, `unknown`, `unspecified` */
+    const ModeType: {
+        readonly Fixed: "fixed";
+        readonly Variable: "variable";
+        readonly Unknown: "unknown";
+        readonly Unspecified: "unspecified";
+    };
+    type ModeType = (typeof ModeType)[keyof typeof ModeType];
+}

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

@@ -0,0 +1,11 @@
+// This file was auto-generated by Fern from our API Definition.
+export var PlaceHubLocationOrderServiceTimeInputRequestBody;
+(function (PlaceHubLocationOrderServiceTimeInputRequestBody) {
+    /** Mode: fixed or variable.  Valid values: `fixed`, `variable`, `unknown`, `unspecified` */
+    PlaceHubLocationOrderServiceTimeInputRequestBody.ModeType = {
+        Fixed: "fixed",
+        Variable: "variable",
+        Unknown: "unknown",
+        Unspecified: "unspecified",
+    };
+})(PlaceHubLocationOrderServiceTimeInputRequestBody || (PlaceHubLocationOrderServiceTimeInputRequestBody = {}));

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

@@ -0,0 +1,7 @@
+/**
+ * Required planner skill reference for a place hub location row.
+ */
+export interface PlaceHubLocationRequiredSkillInputRequestBody {
+    /** Planner skill UUID. */
+    id: string;
+}

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * Additional service time configuration for a hub location row.
+ */
+export interface PlaceHubLocationServiceTimeInputRequestBody {
+    /** Whole minutes of additional service time. */
+    additionalTimeMinutes: number;
+    /** Whether additional service time is enabled. */
+    isEnabled: boolean;
+}

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * Recurring service window for a place hub location row.
+ */
+export interface PlaceHubLocationServiceWindowInputRequestBody {
+    /** Days this window applies. */
+    days: string[];
+    /** End time as seconds since local midnight. */
+    endTime: number;
+    /** Start time as seconds since local midnight. */
+    startTime: number;
+}

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

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

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

@@ -1878,6 +1878,11 @@ export * from "./PersonDetectedResponseBody.mjs";
 export * from "./PhotoValueObjectRequestBody.mjs";
 export * from "./PhotoValueObjectResponseBody.mjs";
 export * from "./PlaceGeofenceVertexResponseResponseBody.mjs";
+export * from "./PlaceHubLocationCapacityServiceTimeInputRequestBody.mjs";
+export * from "./PlaceHubLocationOrderServiceTimeInputRequestBody.mjs";
+export * from "./PlaceHubLocationRequiredSkillInputRequestBody.mjs";
+export * from "./PlaceHubLocationServiceTimeInputRequestBody.mjs";
+export * from "./PlaceHubLocationServiceWindowInputRequestBody.mjs";
 export * from "./PlaceNavigationLocationResponseResponseBody.mjs";
 export * from "./PlaceNavigationResponseResponseBody.mjs";
 export * from "./PlaceResponseObjectResponseBody.mjs";

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

@@ -1878,6 +1878,11 @@ export * from "./PersonDetectedResponseBody.mjs";
 export * from "./PhotoValueObjectRequestBody.mjs";
 export * from "./PhotoValueObjectResponseBody.mjs";
 export * from "./PlaceGeofenceVertexResponseResponseBody.mjs";
+export * from "./PlaceHubLocationCapacityServiceTimeInputRequestBody.mjs";
+export * from "./PlaceHubLocationOrderServiceTimeInputRequestBody.mjs";
+export * from "./PlaceHubLocationRequiredSkillInputRequestBody.mjs";
+export * from "./PlaceHubLocationServiceTimeInputRequestBody.mjs";
+export * from "./PlaceHubLocationServiceWindowInputRequestBody.mjs";
 export * from "./PlaceNavigationLocationResponseResponseBody.mjs";
 export * from "./PlaceNavigationResponseResponseBody.mjs";
 export * from "./PlaceResponseObjectResponseBody.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "13.6.0";
+export declare const SDK_VERSION = "13.8.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "13.6.0";
+export const SDK_VERSION = "13.8.0";

package/package.json

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

package/reference.md

@@ -4454,7 +4454,7 @@ await client.betaApIs.deleteHubRouteTemplate({
 <dl>
 <dd>
 
-Returns places for the authorized organization. Supports cursor pagination or batch fetch by Samsara place ids via `placeIds`.
+Returns places for the authorized organization. Supports cursor pagination or batch fetch by Samsara place ids via `placeIds` or by external ids via `externalIds` (mutually exclusive).
 
  <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>).
 
@@ -4669,7 +4669,7 @@ await client.betaApIs.deletePlace({
 <dl>
 <dd>
 
-Updates a place. Query parameter `placeId` (Samsara id) is required. Optional `externalId` (key:value) is reserved for a future release and must not be combined with `placeId`. Only fields present in the JSON body are changed; omit a field to leave it unchanged.
+Updates a place. Provide exactly one of query parameter `placeId` (Samsara id) or `externalId` (key:value). Only fields present in the JSON body are changed; omit a field to leave it unchanged.
 
  <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>).
 
@@ -4691,9 +4691,7 @@ To use this endpoint, select **Write Places** under the Places category when cre
 <dd>
 
 ```typescript
-await client.betaApIs.patchPlace({
-    placeId: 1000000
-});
+await client.betaApIs.patchPlace();
 
 ```
 </dd>
@@ -5701,7 +5699,33 @@ await client.betaApIs.getQualificationTypes({
 
 Ingest new readings. This endpoint allows the ingestion of batches of readings.
 
-Ingesting readings is only supported for assets created using the POST /assets API endpoint with readingsIngestionEnabled set to true. To see a full list of readings available for ingestion use the GET readings definitions API. When ingesting location data, the readingID 'location' must be used and the value object must contain at least the following fields: 'speed', 'latitude', 'longitude'.
+Ingesting readings is only supported for assets created using the POST /assets API endpoint with readingsIngestionEnabled set to true. To see a full list of readings available for ingestion use the GET readings definitions API.
+
+
+Readings that currently support ingestion (by category):
+
+
+<details>
+<summary><strong>ingestible</strong></summary>
+
+* `batteryVoltage`
+* `coolantTemp`
+* `ecuFuelLevelMillipercent`
+* `engineHours`
+* `engineRpm`
+* `engineState` (values: off | running | idling)
+* `faultCodesJ1939`
+* `faultCodesOBDII`
+* `fuelLevelPerc`
+* `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'.
 
 Related guide: [Readings](https://developers.samsara.com/docs/readings).