@samsarahq/samsara 13.1.0 → 13.3.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.1.0",
-        "User-Agent": "@samsarahq/samsara/13.1.0",
+        "X-Fern-SDK-Version": "13.3.0",
+        "User-Agent": "@samsarahq/samsara/13.3.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

@@ -1240,6 +1240,125 @@ 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`.
+     *
+     *  <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+     *
+     * To use this endpoint, select **Read Places** under the Places category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+     *
+     *
+     *  **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+     *
+     * @param {Samsara.GetPlacesRequest} request
+     * @param {BetaApIsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Samsara.UnauthorizedError}
+     * @throws {@link Samsara.NotFoundError}
+     * @throws {@link Samsara.MethodNotAllowedError}
+     * @throws {@link Samsara.TooManyRequestsError}
+     * @throws {@link Samsara.InternalServerError}
+     * @throws {@link Samsara.NotImplementedError}
+     * @throws {@link Samsara.BadGatewayError}
+     * @throws {@link Samsara.ServiceUnavailableError}
+     * @throws {@link Samsara.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.betaApIs.getPlaces()
+     */
+    getPlaces(request?: Samsara.GetPlacesRequest, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.PlacesGetPlacesResponseBody>;
+    private __getPlaces;
+    /**
+     * Creates a place. Supply either a polygon `geofence` (at least three vertices) or `radiusMeters` with `latitude` and `longitude`.
+     *
+     *  <b>Rate limit:</b> 100 requests/min (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+     *
+     * To use this endpoint, select **Write Places** under the Places category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+     *
+     *
+     *  **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+     *
+     * @param {Samsara.PlacesPostPlaceRequestBody} request
+     * @param {BetaApIsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Samsara.UnauthorizedError}
+     * @throws {@link Samsara.NotFoundError}
+     * @throws {@link Samsara.MethodNotAllowedError}
+     * @throws {@link Samsara.TooManyRequestsError}
+     * @throws {@link Samsara.InternalServerError}
+     * @throws {@link Samsara.NotImplementedError}
+     * @throws {@link Samsara.BadGatewayError}
+     * @throws {@link Samsara.ServiceUnavailableError}
+     * @throws {@link Samsara.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.betaApIs.postPlace({
+     *         address: "123 Main St, Oakland, CA",
+     *         name: "Oakland Yard"
+     *     })
+     */
+    postPlace(request: Samsara.PlacesPostPlaceRequestBody, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.PlacesPostPlaceResponseBody>;
+    private __postPlace;
+    /**
+     * Deletes a place. Pass `placeId` (Samsara id) as a query parameter.
+     *
+     *  <b>Rate limit:</b> 100 requests/min (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+     *
+     * To use this endpoint, select **Write Places** under the Places category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+     *
+     *
+     *  **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+     *
+     * @param {Samsara.DeletePlaceRequest} request
+     * @param {BetaApIsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Samsara.UnauthorizedError}
+     * @throws {@link Samsara.NotFoundError}
+     * @throws {@link Samsara.MethodNotAllowedError}
+     * @throws {@link Samsara.TooManyRequestsError}
+     * @throws {@link Samsara.InternalServerError}
+     * @throws {@link Samsara.NotImplementedError}
+     * @throws {@link Samsara.BadGatewayError}
+     * @throws {@link Samsara.ServiceUnavailableError}
+     * @throws {@link Samsara.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.betaApIs.deletePlace({
+     *         placeId: 1000000
+     *     })
+     */
+    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.
+     *
+     *  <b>Rate limit:</b> 100 requests/min (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+     *
+     * To use this endpoint, select **Write Places** under the Places category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+     *
+     *
+     *  **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+     *
+     * @param {Samsara.PlacesPatchPlaceRequestBody} request
+     * @param {BetaApIsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Samsara.UnauthorizedError}
+     * @throws {@link Samsara.NotFoundError}
+     * @throws {@link Samsara.MethodNotAllowedError}
+     * @throws {@link Samsara.TooManyRequestsError}
+     * @throws {@link Samsara.InternalServerError}
+     * @throws {@link Samsara.NotImplementedError}
+     * @throws {@link Samsara.BadGatewayError}
+     * @throws {@link Samsara.ServiceUnavailableError}
+     * @throws {@link Samsara.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.betaApIs.patchPlace({
+     *         placeId: 1000000
+     *     })
+     */
+    patchPlace(request: Samsara.PlacesPatchPlaceRequestBody, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.PlacesPatchPlaceResponseBody>;
+    private __patchPlace;
     /**
      * Returns qualification records for the specified list of IDs.
      *

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

@@ -3685,6 +3685,357 @@ class BetaApIsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "DELETE", "/hub/route-templates");
         });
     }
+    /**
+     * Returns places for the authorized organization. Supports cursor pagination or batch fetch by Samsara place ids via `placeIds`.
+     *
+     *  <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+     *
+     * To use this endpoint, select **Read Places** under the Places category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+     *
+     *
+     *  **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+     *
+     * @param {Samsara.GetPlacesRequest} request
+     * @param {BetaApIsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Samsara.UnauthorizedError}
+     * @throws {@link Samsara.NotFoundError}
+     * @throws {@link Samsara.MethodNotAllowedError}
+     * @throws {@link Samsara.TooManyRequestsError}
+     * @throws {@link Samsara.InternalServerError}
+     * @throws {@link Samsara.NotImplementedError}
+     * @throws {@link Samsara.BadGatewayError}
+     * @throws {@link Samsara.ServiceUnavailableError}
+     * @throws {@link Samsara.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.betaApIs.getPlaces()
+     */
+    getPlaces(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getPlaces(request, requestOptions));
+    }
+    __getPlaces() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { after, limit, placeIds, externalIds, includeTags, includeExternalIds, tagIds, parentTagIds, placeTypes, name, } = request;
+            const _queryParams = {
+                after,
+                limit,
+                placeIds,
+                externalIds,
+                includeTags,
+                includeExternalIds,
+                tagIds,
+                parentTagIds,
+                placeTypes,
+                name,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "X-Samsara-Version": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.version }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.SamsaraEnvironment.ProductionApi, "places"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Samsara.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Samsara.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 405:
+                        throw new Samsara.MethodNotAllowedError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Samsara.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Samsara.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 501:
+                        throw new Samsara.NotImplementedError(_response.error.body, _response.rawResponse);
+                    case 502:
+                        throw new Samsara.BadGatewayError(_response.error.body, _response.rawResponse);
+                    case 503:
+                        throw new Samsara.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                    case 504:
+                        throw new Samsara.GatewayTimeoutError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.SamsaraError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/places");
+        });
+    }
+    /**
+     * Creates a place. Supply either a polygon `geofence` (at least three vertices) or `radiusMeters` with `latitude` and `longitude`.
+     *
+     *  <b>Rate limit:</b> 100 requests/min (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+     *
+     * To use this endpoint, select **Write Places** under the Places category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+     *
+     *
+     *  **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+     *
+     * @param {Samsara.PlacesPostPlaceRequestBody} request
+     * @param {BetaApIsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Samsara.UnauthorizedError}
+     * @throws {@link Samsara.NotFoundError}
+     * @throws {@link Samsara.MethodNotAllowedError}
+     * @throws {@link Samsara.TooManyRequestsError}
+     * @throws {@link Samsara.InternalServerError}
+     * @throws {@link Samsara.NotImplementedError}
+     * @throws {@link Samsara.BadGatewayError}
+     * @throws {@link Samsara.ServiceUnavailableError}
+     * @throws {@link Samsara.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.betaApIs.postPlace({
+     *         address: "123 Main St, Oakland, CA",
+     *         name: "Oakland Yard"
+     *     })
+     */
+    postPlace(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__postPlace(request, requestOptions));
+    }
+    __postPlace(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "X-Samsara-Version": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.version }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.SamsaraEnvironment.ProductionApi, "places"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Samsara.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Samsara.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 405:
+                        throw new Samsara.MethodNotAllowedError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Samsara.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Samsara.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 501:
+                        throw new Samsara.NotImplementedError(_response.error.body, _response.rawResponse);
+                    case 502:
+                        throw new Samsara.BadGatewayError(_response.error.body, _response.rawResponse);
+                    case 503:
+                        throw new Samsara.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                    case 504:
+                        throw new Samsara.GatewayTimeoutError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.SamsaraError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/places");
+        });
+    }
+    /**
+     * Deletes a place. Pass `placeId` (Samsara id) as a query parameter.
+     *
+     *  <b>Rate limit:</b> 100 requests/min (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+     *
+     * To use this endpoint, select **Write Places** under the Places category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+     *
+     *
+     *  **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+     *
+     * @param {Samsara.DeletePlaceRequest} request
+     * @param {BetaApIsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Samsara.UnauthorizedError}
+     * @throws {@link Samsara.NotFoundError}
+     * @throws {@link Samsara.MethodNotAllowedError}
+     * @throws {@link Samsara.TooManyRequestsError}
+     * @throws {@link Samsara.InternalServerError}
+     * @throws {@link Samsara.NotImplementedError}
+     * @throws {@link Samsara.BadGatewayError}
+     * @throws {@link Samsara.ServiceUnavailableError}
+     * @throws {@link Samsara.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.betaApIs.deletePlace({
+     *         placeId: 1000000
+     *     })
+     */
+    deletePlace(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__deletePlace(request, requestOptions));
+    }
+    __deletePlace(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { placeId } = request;
+            const _queryParams = {
+                placeId,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "X-Samsara-Version": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.version }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.SamsaraEnvironment.ProductionApi, "places"),
+                method: "DELETE",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: undefined, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Samsara.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Samsara.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 405:
+                        throw new Samsara.MethodNotAllowedError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Samsara.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Samsara.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 501:
+                        throw new Samsara.NotImplementedError(_response.error.body, _response.rawResponse);
+                    case 502:
+                        throw new Samsara.BadGatewayError(_response.error.body, _response.rawResponse);
+                    case 503:
+                        throw new Samsara.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                    case 504:
+                        throw new Samsara.GatewayTimeoutError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.SamsaraError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "DELETE", "/places");
+        });
+    }
+    /**
+     * 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.
+     *
+     *  <b>Rate limit:</b> 100 requests/min (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+     *
+     * To use this endpoint, select **Write Places** under the Places category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+     *
+     *
+     *  **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+     *
+     * @param {Samsara.PlacesPatchPlaceRequestBody} request
+     * @param {BetaApIsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Samsara.UnauthorizedError}
+     * @throws {@link Samsara.NotFoundError}
+     * @throws {@link Samsara.MethodNotAllowedError}
+     * @throws {@link Samsara.TooManyRequestsError}
+     * @throws {@link Samsara.InternalServerError}
+     * @throws {@link Samsara.NotImplementedError}
+     * @throws {@link Samsara.BadGatewayError}
+     * @throws {@link Samsara.ServiceUnavailableError}
+     * @throws {@link Samsara.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.betaApIs.patchPlace({
+     *         placeId: 1000000
+     *     })
+     */
+    patchPlace(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__patchPlace(request, requestOptions));
+    }
+    __patchPlace(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { placeId, externalId } = request, _body = __rest(request, ["placeId", "externalId"]);
+            const _queryParams = {
+                placeId,
+                externalId,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "X-Samsara-Version": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.version }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.SamsaraEnvironment.ProductionApi, "places"),
+                method: "PATCH",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                requestType: "json",
+                body: _body,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Samsara.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Samsara.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 405:
+                        throw new Samsara.MethodNotAllowedError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Samsara.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Samsara.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 501:
+                        throw new Samsara.NotImplementedError(_response.error.body, _response.rawResponse);
+                    case 502:
+                        throw new Samsara.BadGatewayError(_response.error.body, _response.rawResponse);
+                    case 503:
+                        throw new Samsara.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                    case 504:
+                        throw new Samsara.GatewayTimeoutError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.SamsaraError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "PATCH", "/places");
+        });
+    }
     /**
      * Returns qualification records for the specified list of IDs.
      *

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

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         placeId: 1000000
+ *     }
+ */
+export interface DeletePlaceRequest {
+    /** Samsara place id to delete. */
+    placeId: number;
+}

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * @example
+ *     {}
+ */
+export interface GetPlacesRequest {
+    /**  If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results. */
+    after?: string;
+    /** The limit for how many objects will be in the response. Default and max for this value is 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. */
+    placeIds?: string;
+    /** Reserved. Batch lookup by external IDs is not implemented in this API version. */
+    externalIds?: string;
+    /** When true, expands tag objects on each place. Defaults to false. */
+    includeTags?: boolean;
+    /** When true, includes externalIds on each place. Defaults to false. */
+    includeExternalIds?: boolean;
+    /** Comma-separated numeric tag IDs to filter places. */
+    tagIds?: string;
+    /** Reserved. Filtering by parent tag IDs is not implemented in this API version. */
+    parentTagIds?: string;
+    /** Comma-separated place type tokens (e.g. yard,normalGeofence). */
+    placeTypes?: string;
+    /** Filter places by name text. */
+    name?: string;
+}

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

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

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

@@ -0,0 +1,41 @@
+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. */
+    externalId?: string;
+    /** Single-line address string. */
+    address?: string;
+    /** When present, replaces external ids for the place. */
+    externalIds?: PlacesPatchPlaceRequestBody.ExternalIds;
+    /** Polygon vertices; at least three when switching to polygon mode. */
+    geofence?: Samsara.GeofenceVertexInputRequestBody[];
+    hubLocations?: Samsara.PatchPlaceHubLocationsBodyRequestBody;
+    /** Center latitude when switching to or editing a circle geofence. */
+    latitude?: number;
+    /** Center longitude when switching to or editing a circle geofence. */
+    longitude?: number;
+    /** Place name. */
+    name?: string;
+    navigation?: Samsara.PostPlaceNavigationInputRequestBody;
+    /** Notes. */
+    notes?: string;
+    /** Unsupported on patch; when provided this API returns InvalidArgument. */
+    placeTypes?: string[];
+    /** Circle radius in meters; use with latitude and longitude. */
+    radiusMeters?: number;
+    /** When present, replaces all tag associations for the place. */
+    tags?: Samsara.PostPlaceTagRefRequestBody[];
+}
+export declare namespace PlacesPatchPlaceRequestBody {
+    /**
+     * When present, replaces external ids for the place.
+     */
+    type ExternalIds = {};
+}

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

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

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

@@ -0,0 +1,39 @@
+import type * as Samsara from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         address: "123 Main St, Oakland, CA",
+ *         name: "Oakland Yard"
+ *     }
+ */
+export interface PlacesPostPlaceRequestBody {
+    /** Single-line address string. */
+    address: string;
+    /** External identifiers. */
+    externalIds?: PlacesPostPlaceRequestBody.ExternalIds;
+    /** Polygon vertices; at least three when using polygon mode (omit entirely when using latitude, longitude, and radiusMeters for a circle). */
+    geofence?: Samsara.GeofenceVertexInputRequestBody[];
+    /** Initial route-planning hub rows for the new place. Each entry requires hubId. Omit hubLocationId to let the server assign a row UUID, or set hubLocationId to pin the UUID for idempotent creates. */
+    hubLocations?: Samsara.PatchPlaceHubLocationUpsertBodyRequestBody[];
+    /** Center latitude when using a circle geofence with radiusMeters. */
+    latitude?: number;
+    /** Center longitude when using a circle geofence with radiusMeters. */
+    longitude?: number;
+    /** Place name. */
+    name: string;
+    navigation?: Samsara.PostPlaceNavigationInputRequestBody;
+    /** Optional notes. */
+    notes?: string;
+    /** Unsupported on create; when provided this API returns InvalidArgument. */
+    placeTypes?: string[];
+    /** Circle radius in meters; requires latitude and longitude. Must be at least 1 when set. */
+    radiusMeters?: number;
+    /** Tags to associate. */
+    tags?: Samsara.PostPlaceTagRefRequestBody[];
+}
+export declare namespace PlacesPostPlaceRequestBody {
+    /**
+     * External identifiers.
+     */
+    type ExternalIds = {};
+}

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

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