@samsarahq/samsara 13.23.0 → 13.24.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.23.0",
-        "User-Agent": "@samsarahq/samsara/13.23.0",
+        "X-Fern-SDK-Version": "13.24.0",
+        "User-Agent": "@samsarahq/samsara/13.24.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

@@ -715,6 +715,62 @@ export declare class BetaApIsClient {
      */
     listTachographLiveData(request?: Samsara.ListTachographLiveDataRequest, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.EntityTachographLiveDataRecordsServiceListTachographLiveDataResponseBody>;
     private __listTachographLiveData;
+    /**
+     * Reserve a tachograph file upload and return a presigned URL. Upload the file bytes directly to the URL with the returned headers. The driver or device the file belongs to is resolved from the file contents after upload.
+     *
+     * **Uploading the file**
+     *
+     * Once you have the `uploadUrl` and `requiredHeaders` from the response, PUT the raw file bytes directly to the URL — do not send the request through the Samsara API servers:
+     *
+     * ```bash
+     * curl -X PUT "<uploadUrl>" \
+     *   -H "Content-Type: <value from requiredHeaders>" \
+     *   -H "Content-MD5: <value from requiredHeaders>" \
+     *   -H "Content-Length: <value from requiredHeaders>" \
+     *   --data-binary @/path/to/file.ddd
+     * ```
+     *
+     * Every header listed in `requiredHeaders` must be sent verbatim — they are part of the URL signature, and the upload is rejected with a `403` if any header is missing or has a different value.
+     *
+     * **Retrieving uploaded files**
+     *
+     * A successful response to this request reserves the upload; it does not indicate that a file has been received or processed. Uploaded files are processed asynchronously after the PUT completes. Once a file has been processed, it can be retrieved through the standard tachograph file endpoints:
+     *
+     * - **Driver-card files** — `GET /fleet/drivers/tachograph-files/history`
+     * - **Vehicle-unit files** — `GET /fleet/vehicles/tachograph-files/history`
+     *
+     * Files that cannot be processed — for example files that are corrupt, are not valid tachograph files, or cannot be matched to a driver or vehicle in your organization — are not retrievable through these endpoints.
+     *
+     *  <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 Tachograph (EU)** under the Compliance 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.TachographFileUploadsPostTachographFileUploadRequestBody} 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.postTachographFileUpload({
+     *         contentMd5: "rL0Y20zC+Fzt72VPzMSk2A==",
+     *         contentType: "application/octet-stream",
+     *         fileSizeBytes: 8192,
+     *         fileType: "driverCard"
+     *     })
+     */
+    postTachographFileUpload(request: Samsara.TachographFileUploadsPostTachographFileUploadRequestBody, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.TachographFileUploadsPostTachographFileUploadResponseBody>;
+    private __postTachographFileUpload;
     /**
      * Get the engine immobilizer states of the queried vehicles. If a vehicle has never had an engine immobilizer connected, there won't be any state returned for that vehicle.
      *

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

@@ -2184,6 +2184,119 @@ class BetaApIsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/fleet/tachograph-live-data/latest");
         });
     }
+    /**
+     * Reserve a tachograph file upload and return a presigned URL. Upload the file bytes directly to the URL with the returned headers. The driver or device the file belongs to is resolved from the file contents after upload.
+     *
+     * **Uploading the file**
+     *
+     * Once you have the `uploadUrl` and `requiredHeaders` from the response, PUT the raw file bytes directly to the URL — do not send the request through the Samsara API servers:
+     *
+     * ```bash
+     * curl -X PUT "<uploadUrl>" \
+     *   -H "Content-Type: <value from requiredHeaders>" \
+     *   -H "Content-MD5: <value from requiredHeaders>" \
+     *   -H "Content-Length: <value from requiredHeaders>" \
+     *   --data-binary @/path/to/file.ddd
+     * ```
+     *
+     * Every header listed in `requiredHeaders` must be sent verbatim — they are part of the URL signature, and the upload is rejected with a `403` if any header is missing or has a different value.
+     *
+     * **Retrieving uploaded files**
+     *
+     * A successful response to this request reserves the upload; it does not indicate that a file has been received or processed. Uploaded files are processed asynchronously after the PUT completes. Once a file has been processed, it can be retrieved through the standard tachograph file endpoints:
+     *
+     * - **Driver-card files** — `GET /fleet/drivers/tachograph-files/history`
+     * - **Vehicle-unit files** — `GET /fleet/vehicles/tachograph-files/history`
+     *
+     * Files that cannot be processed — for example files that are corrupt, are not valid tachograph files, or cannot be matched to a driver or vehicle in your organization — are not retrievable through these endpoints.
+     *
+     *  <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 Tachograph (EU)** under the Compliance 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.TachographFileUploadsPostTachographFileUploadRequestBody} 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.postTachographFileUpload({
+     *         contentMd5: "rL0Y20zC+Fzt72VPzMSk2A==",
+     *         contentType: "application/octet-stream",
+     *         fileSizeBytes: 8192,
+     *         fileType: "driverCard"
+     *     })
+     */
+    postTachographFileUpload(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__postTachographFileUpload(request, requestOptions));
+    }
+    __postTachographFileUpload(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, "fleet/tachograph/file-uploads"),
+                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", "/fleet/tachograph/file-uploads");
+        });
+    }
     /**
      * Get the engine immobilizer states of the queried vehicles. If a vehicle has never had an engine immobilizer connected, there won't be any state returned for that vehicle.
      *

package/dist/cjs/api/resources/{previewApIs → betaApIs}/client/requests/TachographFileUploadsPostTachographFileUploadRequestBody.d.ts

@@ -12,7 +12,7 @@ export interface TachographFileUploadsPostTachographFileUploadRequestBody {
     contentMd5: string;
     /** The MIME content type of the file. The upload is sent to object storage as raw bytes.  Valid values: `application/octet-stream` */
     contentType: TachographFileUploadsPostTachographFileUploadRequestBody.ContentType;
-    /** The size of the file in bytes. Enforced as the Content-Length on upload and validated against the maximum allowed tachograph file size. */
+    /** The size of the file in bytes. Enforced as the Content-Length on upload. Maximum 10 MB (10485760 bytes). */
     fileSizeBytes: number;
     /** The kind of tachograph file being uploaded. The driver or device the file belongs to is resolved from the file contents, not from this field.  Valid values: `driverCard`, `vehicleUnit` */
     fileType: TachographFileUploadsPostTachographFileUploadRequestBody.FileType;

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

@@ -79,4 +79,5 @@ export { RidershipPassengersUpdateRidershipPassengerRequestBody } from "./Riders
 export type { RidershipRouteSetupsCreateRidershipRouteSetupRequestBody } from "./RidershipRouteSetupsCreateRidershipRouteSetupRequestBody.js";
 export type { RidershipRouteSetupsUpdateRidershipRouteSetupRequestBody } from "./RidershipRouteSetupsUpdateRidershipRouteSetupRequestBody.js";
 export { SafetyEventsV2PatchSafetyEventsV2BatchRequestBody } from "./SafetyEventsV2PatchSafetyEventsV2BatchRequestBody.js";
+export { TachographFileUploadsPostTachographFileUploadRequestBody } from "./TachographFileUploadsPostTachographFileUploadRequestBody.js";
 export type { UpdateFunctionStorageFileRequest } from "./UpdateFunctionStorageFileRequest.js";

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SafetyEventsV2PatchSafetyEventsV2BatchRequestBody = exports.RidershipPassengersUpdateRidershipPassengerRequestBody = exports.RidershipPassengersCreateRidershipPassengerRequestBody = exports.PlacesPostPlaceRequestBody = exports.PlacesPatchPlaceRequestBody = exports.DeviceRecoveryRecoverAssetRequestBody = void 0;
+exports.TachographFileUploadsPostTachographFileUploadRequestBody = exports.SafetyEventsV2PatchSafetyEventsV2BatchRequestBody = exports.RidershipPassengersUpdateRidershipPassengerRequestBody = exports.RidershipPassengersCreateRidershipPassengerRequestBody = exports.PlacesPostPlaceRequestBody = exports.PlacesPatchPlaceRequestBody = exports.DeviceRecoveryRecoverAssetRequestBody = void 0;
 var DeviceRecoveryRecoverAssetRequestBody_js_1 = require("./DeviceRecoveryRecoverAssetRequestBody.js");
 Object.defineProperty(exports, "DeviceRecoveryRecoverAssetRequestBody", { enumerable: true, get: function () { return DeviceRecoveryRecoverAssetRequestBody_js_1.DeviceRecoveryRecoverAssetRequestBody; } });
 var PlacesPatchPlaceRequestBody_js_1 = require("./PlacesPatchPlaceRequestBody.js");
@@ -13,3 +13,5 @@ var RidershipPassengersUpdateRidershipPassengerRequestBody_js_1 = require("./Rid
 Object.defineProperty(exports, "RidershipPassengersUpdateRidershipPassengerRequestBody", { enumerable: true, get: function () { return RidershipPassengersUpdateRidershipPassengerRequestBody_js_1.RidershipPassengersUpdateRidershipPassengerRequestBody; } });
 var SafetyEventsV2PatchSafetyEventsV2BatchRequestBody_js_1 = require("./SafetyEventsV2PatchSafetyEventsV2BatchRequestBody.js");
 Object.defineProperty(exports, "SafetyEventsV2PatchSafetyEventsV2BatchRequestBody", { enumerable: true, get: function () { return SafetyEventsV2PatchSafetyEventsV2BatchRequestBody_js_1.SafetyEventsV2PatchSafetyEventsV2BatchRequestBody; } });
+var TachographFileUploadsPostTachographFileUploadRequestBody_js_1 = require("./TachographFileUploadsPostTachographFileUploadRequestBody.js");
+Object.defineProperty(exports, "TachographFileUploadsPostTachographFileUploadRequestBody", { enumerable: true, get: function () { return TachographFileUploadsPostTachographFileUploadRequestBody_js_1.TachographFileUploadsPostTachographFileUploadRequestBody; } });

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

@@ -47,11 +47,11 @@ export declare class PreviewApIsClient {
     createDriverAuthToken(request: Samsara.DriversAuthTokenCreateDriverAuthTokenRequestBody, requestOptions?: PreviewApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.DriversAuthTokenCreateDriverAuthTokenResponseBody>;
     private __createDriverAuthToken;
     /**
-     * Reserve a tachograph file upload and return a presigned URL. Upload the file bytes directly to the URL with the returned headers. The driver or device the file belongs to is resolved from the file contents after upload.
+     * Returns fleet installer photo upload sessions for the caller's org. Results are ordered by updatedAtTime ascending and paginated (up to 25 per page). Supports filtering by session IDs, startTime, and endTime. Omitting startTime returns all sessions for the org. endTime requires startTime.
      *
      *  <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 Tachograph (EU)** under the Compliance 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>
+     * To use this endpoint, select **Read Devices** under the Devices 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>
      *
      * Endpoints in this section are in Preview. These APIs are not functional and are instead for soliciting feedback from our API users on the intended design of this API. Additionally, it is not guaranteed that we will be releasing an endpoint included in this section to production. This means that developers should **NOT** rely on these APIs to build business critical applications
      *
@@ -62,7 +62,7 @@ export declare class PreviewApIsClient {
      *
      *  **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.TachographFileUploadsPostTachographFileUploadRequestBody} request
+     * @param {Samsara.GetFleetInstallerPhotoUploadsRequest} request
      * @param {PreviewApIsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Samsara.UnauthorizedError}
@@ -76,15 +76,88 @@ export declare class PreviewApIsClient {
      * @throws {@link Samsara.GatewayTimeoutError}
      *
      * @example
-     *     await client.previewApIs.postTachographFileUpload({
+     *     await client.previewApIs.getFleetInstallerPhotoUploads()
+     */
+    getFleetInstallerPhotoUploads(request?: Samsara.GetFleetInstallerPhotoUploadsRequest, requestOptions?: PreviewApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.FleetInstallerPhotoUploadsGetFleetInstallerPhotoUploadsResponseBody>;
+    private __getFleetInstallerPhotoUploads;
+    /**
+     * Creates a fleet installer photo upload session and returns a presigned S3 PUT URL. Upload the file bytes directly to the presigned URL using the headers in uploadContext, then call POST /fleet/installer/photo-uploads/complete to finalize.
+     *
+     *  <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 Devices** under the Devices 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>
+     *
+     * Endpoints in this section are in Preview. These APIs are not functional and are instead for soliciting feedback from our API users on the intended design of this API. Additionally, it is not guaranteed that we will be releasing an endpoint included in this section to production. This means that developers should **NOT** rely on these APIs to build business critical applications
+     *
+     * - Samsara may change the structure of a preview API's interface without versioning or any notice to API users.
+     *
+     * - When an endpoint becomes generally available, it will be announced in the API [changelog](https://developers.samsara.com/changelog).
+     *
+     *
+     *  **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.FleetInstallerPhotoUploadsPostFleetInstallerPhotoUploadRequestBody} request
+     * @param {PreviewApIsClient.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.previewApIs.postFleetInstallerPhotoUpload({
      *         contentMd5: "rL0Y20zC+Fzt72VPzMSk2A==",
-     *         contentType: "application/octet-stream",
-     *         fileSizeBytes: 8192,
-     *         fileType: "driverCard"
+     *         deviceId: "281474977961335",
+     *         fileFormatType: "imageJpeg",
+     *         fileName: "front_camera_install.jpg",
+     *         hardwareType: "vehicleGateway",
+     *         photoType: "installPhoto",
+     *         sizeBytes: 482193
+     *     })
+     */
+    postFleetInstallerPhotoUpload(request: Samsara.FleetInstallerPhotoUploadsPostFleetInstallerPhotoUploadRequestBody, requestOptions?: PreviewApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.FleetInstallerPhotoUploadsPostFleetInstallerPhotoUploadResponseBody>;
+    private __postFleetInstallerPhotoUpload;
+    /**
+     * Marks a fleet installer photo upload session as complete after the file bytes have been uploaded to S3. Triggers async processing of the photo. Poll GET /fleet/installer/photo-uploads to observe the final state.
+     *
+     *  <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 Devices** under the Devices 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>
+     *
+     * Endpoints in this section are in Preview. These APIs are not functional and are instead for soliciting feedback from our API users on the intended design of this API. Additionally, it is not guaranteed that we will be releasing an endpoint included in this section to production. This means that developers should **NOT** rely on these APIs to build business critical applications
+     *
+     * - Samsara may change the structure of a preview API's interface without versioning or any notice to API users.
+     *
+     * - When an endpoint becomes generally available, it will be announced in the API [changelog](https://developers.samsara.com/changelog).
+     *
+     *
+     *  **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.PostFleetInstallerPhotoUploadCompleteRequest} request
+     * @param {PreviewApIsClient.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.previewApIs.postFleetInstallerPhotoUploadComplete({
+     *         id: "id"
      *     })
      */
-    postTachographFileUpload(request: Samsara.TachographFileUploadsPostTachographFileUploadRequestBody, requestOptions?: PreviewApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.TachographFileUploadsPostTachographFileUploadResponseBody>;
-    private __postTachographFileUpload;
+    postFleetInstallerPhotoUploadComplete(request: Samsara.PostFleetInstallerPhotoUploadCompleteRequest, requestOptions?: PreviewApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.FleetInstallerPhotoUploadsPostFleetInstallerPhotoUploadCompleteResponseBody>;
+    private __postFleetInstallerPhotoUploadComplete;
     /**
      * Lock a vehicle. This requires a vehicle gateway with locking capabilities.
      *

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

@@ -149,11 +149,11 @@ class PreviewApIsClient {
         });
     }
     /**
-     * Reserve a tachograph file upload and return a presigned URL. Upload the file bytes directly to the URL with the returned headers. The driver or device the file belongs to is resolved from the file contents after upload.
+     * Returns fleet installer photo upload sessions for the caller's org. Results are ordered by updatedAtTime ascending and paginated (up to 25 per page). Supports filtering by session IDs, startTime, and endTime. Omitting startTime returns all sessions for the org. endTime requires startTime.
      *
      *  <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 Tachograph (EU)** under the Compliance 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>
+     * To use this endpoint, select **Read Devices** under the Devices 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>
      *
      * Endpoints in this section are in Preview. These APIs are not functional and are instead for soliciting feedback from our API users on the intended design of this API. Additionally, it is not guaranteed that we will be releasing an endpoint included in this section to production. This means that developers should **NOT** rely on these APIs to build business critical applications
      *
@@ -164,7 +164,7 @@ class PreviewApIsClient {
      *
      *  **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.TachographFileUploadsPostTachographFileUploadRequestBody} request
+     * @param {Samsara.GetFleetInstallerPhotoUploadsRequest} request
      * @param {PreviewApIsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Samsara.UnauthorizedError}
@@ -178,23 +178,121 @@ class PreviewApIsClient {
      * @throws {@link Samsara.GatewayTimeoutError}
      *
      * @example
-     *     await client.previewApIs.postTachographFileUpload({
+     *     await client.previewApIs.getFleetInstallerPhotoUploads()
+     */
+    getFleetInstallerPhotoUploads(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getFleetInstallerPhotoUploads(request, requestOptions));
+    }
+    __getFleetInstallerPhotoUploads() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { ids, startTime, endTime, after } = request;
+            const _queryParams = {
+                ids,
+                startTime,
+                endTime,
+                after,
+            };
+            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, "preview/fleet/installer/photo-uploads"),
+                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", "/preview/fleet/installer/photo-uploads");
+        });
+    }
+    /**
+     * Creates a fleet installer photo upload session and returns a presigned S3 PUT URL. Upload the file bytes directly to the presigned URL using the headers in uploadContext, then call POST /fleet/installer/photo-uploads/complete to finalize.
+     *
+     *  <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 Devices** under the Devices 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>
+     *
+     * Endpoints in this section are in Preview. These APIs are not functional and are instead for soliciting feedback from our API users on the intended design of this API. Additionally, it is not guaranteed that we will be releasing an endpoint included in this section to production. This means that developers should **NOT** rely on these APIs to build business critical applications
+     *
+     * - Samsara may change the structure of a preview API's interface without versioning or any notice to API users.
+     *
+     * - When an endpoint becomes generally available, it will be announced in the API [changelog](https://developers.samsara.com/changelog).
+     *
+     *
+     *  **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.FleetInstallerPhotoUploadsPostFleetInstallerPhotoUploadRequestBody} request
+     * @param {PreviewApIsClient.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.previewApIs.postFleetInstallerPhotoUpload({
      *         contentMd5: "rL0Y20zC+Fzt72VPzMSk2A==",
-     *         contentType: "application/octet-stream",
-     *         fileSizeBytes: 8192,
-     *         fileType: "driverCard"
+     *         deviceId: "281474977961335",
+     *         fileFormatType: "imageJpeg",
+     *         fileName: "front_camera_install.jpg",
+     *         hardwareType: "vehicleGateway",
+     *         photoType: "installPhoto",
+     *         sizeBytes: 482193
      *     })
      */
-    postTachographFileUpload(request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__postTachographFileUpload(request, requestOptions));
+    postFleetInstallerPhotoUpload(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__postFleetInstallerPhotoUpload(request, requestOptions));
     }
-    __postTachographFileUpload(request, requestOptions) {
+    __postFleetInstallerPhotoUpload(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, "preview/fleet/tachograph/file-uploads"),
+                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, "preview/fleet/installer/photo-uploads"),
                 method: "POST",
                 headers: _headers,
                 contentType: "application/json",
@@ -241,7 +339,101 @@ class PreviewApIsClient {
                         });
                 }
             }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/preview/fleet/tachograph/file-uploads");
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/preview/fleet/installer/photo-uploads");
+        });
+    }
+    /**
+     * Marks a fleet installer photo upload session as complete after the file bytes have been uploaded to S3. Triggers async processing of the photo. Poll GET /fleet/installer/photo-uploads to observe the final state.
+     *
+     *  <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 Devices** under the Devices 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>
+     *
+     * Endpoints in this section are in Preview. These APIs are not functional and are instead for soliciting feedback from our API users on the intended design of this API. Additionally, it is not guaranteed that we will be releasing an endpoint included in this section to production. This means that developers should **NOT** rely on these APIs to build business critical applications
+     *
+     * - Samsara may change the structure of a preview API's interface without versioning or any notice to API users.
+     *
+     * - When an endpoint becomes generally available, it will be announced in the API [changelog](https://developers.samsara.com/changelog).
+     *
+     *
+     *  **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.PostFleetInstallerPhotoUploadCompleteRequest} request
+     * @param {PreviewApIsClient.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.previewApIs.postFleetInstallerPhotoUploadComplete({
+     *         id: "id"
+     *     })
+     */
+    postFleetInstallerPhotoUploadComplete(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__postFleetInstallerPhotoUploadComplete(request, requestOptions));
+    }
+    __postFleetInstallerPhotoUploadComplete(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { id } = request;
+            const _queryParams = {
+                id,
+            };
+            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, "preview/fleet/installer/photo-uploads/complete"),
+                method: "POST",
+                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, "POST", "/preview/fleet/installer/photo-uploads/complete");
         });
     }
     /**