@mobilerun/sdk 5.6.0 → 6.0.1

package/src/resources/devices/apps.ts

@@ -79,16 +79,18 @@ export class Apps extends APIResource {
 
   /**
    * Requests an app install on the device. The request body must supply exactly one
-   * of an Android packageName or an iOS bundleId; optional country and versionCode
-   * select an exact regional uploaded Android version, and protected packages are
-   * rejected. background (default false) selects the response contract: false
-   * installs inline and returns the outcome directly (200 on success, an error
-   * status on failure); true accepts the request and runs the download + install in
-   * the background, returning 202 immediately — poll list-app-installs for the
-   * backend's view of that attempt's status. Refuses with 409 once 2 other installs
-   * are already running on the device, in either mode; a repeat request for an app
-   * that already has an install running is also refused with 409 rather than
-   * superseding it — retry once that attempt reaches a terminal state.
+   * of an Android packageName or an iOS bundleId. For packageName installs, optional
+   * country and versionCode select an exact regional uploaded Android version, and
+   * protected packages are rejected. background (default false) selects the response
+   * contract: false installs inline and returns the outcome directly (200 on
+   * success, an error status on failure); true accepts the request and runs the
+   * download + install in the background, returning 202 immediately — poll
+   * list-app-installs for the backend's view of that attempt's status. Refuses with
+   * 409 once 2 other installs are already running on the device, in either mode; a
+   * repeat request for an app that already has an install running is also refused
+   * with 409 rather than superseding it — retry once that attempt reaches a terminal
+   * state. Synchronous failures report APP_DOWNLOAD_FAILED (502) when the app file
+   * cannot be downloaded or APP_INSTALL_TIMEOUT (504) when the install times out.
    */
   install(deviceID: string, params: AppInstallParams, options?: RequestOptions): APIPromise<void> {
     const { 'X-Device-Display-ID': xDeviceDisplayID, ...body } = params;
@@ -215,6 +217,18 @@ export namespace AppListResponse {
     versionCode: number;
 
     versionName: string;
+
+    availableUpdate?: AppListResponseItem.AvailableUpdate;
+  }
+
+  export namespace AppListResponseItem {
+    export interface AvailableUpdate {
+      country: string;
+
+      versionCode: number;
+
+      versionName: string;
+    }
   }
 }
 
@@ -267,6 +281,12 @@ export interface AppListParams {
    */
   includeSystemApps?: boolean;
 
+  /**
+   * Query param: Resolve availableUpdate for Android user apps (one library lookup
+   * per app). Off by default.
+   */
+  includeUpdates?: boolean;
+
   /**
    * Header param
    */

package/src/resources/devices/devices.ts

@@ -50,16 +50,6 @@ import * as LanguageAPI from './language';
 import { Language, LanguageGetParams, LanguageGetResponse, LanguageSetParams } from './language';
 import * as LocationAPI from './location';
 import { Location, LocationGetParams, LocationResetParams, LocationSetParams } from './location';
-import * as MediaSessionsAPI from './media-sessions';
-import {
-  MediaSessionActivateParams,
-  MediaSessionActivateResponse,
-  MediaSessionCreateParams,
-  MediaSessionCreateResponse,
-  MediaSessionDeleteParams,
-  MediaSessionRetrieveCurrentResponse,
-  MediaSessions,
-} from './media-sessions';
 import * as PackagesAPI from './packages';
 import { PackageListParams, PackageListResponse, Packages } from './packages';
 import * as ProfileAPI from './profile';
@@ -77,6 +67,8 @@ import {
   RecordingDeleteParams,
   RecordingListParams,
   RecordingListResponse,
+  RecordingScreenshotsParams,
+  RecordingScreenshotsResponse,
   RecordingStartParams,
   RecordingStartResponse,
   RecordingStatusParams,
@@ -87,6 +79,16 @@ import {
   RecordingVideoParams,
   Recordings,
 } from './recordings';
+import * as ScreenshotsAPI from './screenshots';
+import {
+  ScreenshotCaptureParams,
+  ScreenshotCaptureResponse,
+  ScreenshotDeleteParams,
+  ScreenshotImageParams,
+  ScreenshotListParams,
+  ScreenshotListResponse,
+  Screenshots,
+} from './screenshots';
 import * as StateAPI from './state';
 import {
   A11YNode,
@@ -142,6 +144,7 @@ export class Devices extends APIResource {
   packages: PackagesAPI.Packages = new PackagesAPI.Packages(this._client);
   profile: ProfileAPI.Profile = new ProfileAPI.Profile(this._client);
   proxy: ProxyAPI.Proxy = new ProxyAPI.Proxy(this._client);
+  screenshots: ScreenshotsAPI.Screenshots = new ScreenshotsAPI.Screenshots(this._client);
   state: StateAPI.State = new StateAPI.State(this._client);
   tasks: TasksAPI.Tasks = new TasksAPI.Tasks(this._client);
   clipboard: ClipboardAPI.Clipboard = new ClipboardAPI.Clipboard(this._client);
@@ -150,7 +153,6 @@ export class Devices extends APIResource {
   deepLink: DeepLinkAPI.DeepLink = new DeepLinkAPI.DeepLink(this._client);
   browser: BrowserAPI.Browser = new BrowserAPI.Browser(this._client);
   kiosk: KioskAPI.Kiosk = new KioskAPI.Kiosk(this._client);
-  mediaSessions: MediaSessionsAPI.MediaSessions = new MediaSessionsAPI.MediaSessions(this._client);
   recordings: RecordingsAPI.Recordings = new RecordingsAPI.Recordings(this._client);
   trafficSessions: TrafficSessionsAPI.TrafficSessions = new TrafficSessionsAPI.TrafficSessions(this._client);
 
@@ -180,6 +182,10 @@ export class Devices extends APIResource {
 
   /**
    * Returns a paginated list of the user's devices along with pagination metadata.
+   * By default every device except terminated and unknown-state ones is listed,
+   * including stopped and maintenance devices; narrow with e.g. `state=ready` or
+   * `state=stopped,maintenance`, and pass `state=terminated` or `state=unknown` to
+   * see those.
    */
   list(
     query: DeviceListParams | null | undefined = {},
@@ -235,12 +241,24 @@ export class Devices extends APIResource {
   }
 
   /**
-   * Resets the device back to a clean state, clearing installed apps and user data
-   * accumulated during the session. The device transitions through its reset
-   * lifecycle before becoming ready again.
+   * Resets the device. The optional body `mode` selects what is erased: `full` is a
+   * factory reset that erases installed apps, accounts and storage and gives the
+   * device a new identity; `identity` gives the device a new fingerprint and keeps
+   * its apps and data. When `mode` is omitted the reset is `full`, or `identity` on
+   * devices whose capabilities report `factoryReset=false`. A mode the device does
+   * not support (see `factoryReset` / `identityReset` in the device capabilities) is
+   * refused with 400 `DEVICE_TOOL_UNSUPPORTED`; legacy devices accept an explicit
+   * mode only when it is the one their capabilities advertise, and always accept a
+   * reset without a mode. The device transitions through its reset lifecycle before
+   * becoming ready again.
    */
-  reset(deviceID: string, options?: RequestOptions): APIPromise<void> {
+  reset(
+    deviceID: string,
+    body: DeviceResetParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
     return this._client.post(path`/devices/${deviceID}/reset`, {
+      body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
@@ -259,11 +277,8 @@ export class Devices extends APIResource {
   }
 
   /**
-   * Returns the set of capabilities supported by this device. For a legacy device
-   * this reflects the live instance's actual tools rather than its static type; for
-   * a core-managed device it is resolved from provider/pool configuration without
-   * guaranteeing a live instance. Used to determine which tools and features are
-   * available for the device.
+   * Returns the set of capabilities supported by this device. Used to determine
+   * which tools and features are available for the device.
    */
   retrieveCapabilities(
     deviceID: string,
@@ -308,9 +323,9 @@ export class Devices extends APIResource {
   }
 
   /**
-   * Terminates the device and releases its resources. Termination can be scheduled
-   * for a future time or chained from a previous device via the request body, in
-   * which case a service key is required.
+   * Terminates the device and releases its resources. The optional `terminateAt` and
+   * `previousDeviceId` body fields are not available to API-key callers; requests
+   * that set them are rejected with 401.
    */
   terminate(
     deviceID: string,
@@ -570,6 +585,8 @@ export namespace DeviceRetrieveCapabilitiesResponse {
 
     esim: boolean;
 
+    factoryReset: boolean;
+
     files: boolean;
 
     fingerprint: boolean;
@@ -580,6 +597,8 @@ export namespace DeviceRetrieveCapabilitiesResponse {
 
     humanTouch: boolean;
 
+    identityReset: boolean;
+
     language: boolean;
 
     logcat: boolean;
@@ -603,6 +622,8 @@ export namespace DeviceRetrieveCapabilitiesResponse {
     time: boolean;
 
     trafficInspection: boolean;
+
+    mediaInjectionTransport?: 'direct';
   }
 }
 
@@ -848,20 +869,30 @@ export namespace DeviceCreateParams {
 export interface DeviceListParams {
   country?: string;
 
+  /**
+   * Include devices created at or after this RFC3339 timestamp.
+   */
+  createdAfter?: string;
+
+  /**
+   * Include devices created before this RFC3339 timestamp (exclusive). Must be later
+   * than createdAfter when both are set.
+   */
+  createdBefore?: string;
+
   /**
    * Filter to devices created by this user id. Mutually exclusive with mine.
    */
   createdBy?: string;
 
   /**
-   * When true, only return devices created by the calling user (resolved from
-   * X-User-ID, never a client-supplied id).
+   * When true, only return devices created by the authenticated caller.
    */
   mine?: boolean;
 
   name?: string;
 
-  orderBy?: 'id' | 'createdAt' | 'updatedAt' | 'assignedAt';
+  orderBy?: 'id' | 'createdAt' | 'updatedAt' | 'assignedAt' | 'gridPosition';
 
   orderByDirection?: 'asc' | 'desc';
 
@@ -877,6 +908,17 @@ export interface DeviceListParams {
 
   providerId?: string;
 
+  /**
+   * Case-insensitive search: matches devices whose name contains the term or whose
+   * ID starts with it. Combined with all other filters.
+   */
+  search?: string;
+
+  /**
+   * Filter by current device state. Comma-separated (state=ready,stopped). Defaults
+   * to every state except terminated and unknown, so stopped and maintenance devices
+   * are listed; pass state=terminated or state=unknown to see those.
+   */
   state?: Array<
     | 'creating'
     | 'assigned'
@@ -907,6 +949,16 @@ export interface DeviceFingerprintParams {
   'X-Device-Display-ID'?: number;
 }
 
+export interface DeviceResetParams {
+  /**
+   * What to erase. full: factory reset — erases the user data (apps, accounts,
+   * storage) and gives the device a new identity. identity: new device fingerprint,
+   * apps and data are kept. When omitted: full, or identity on devices whose
+   * capabilities report factoryReset=false.
+   */
+  mode?: 'full' | 'identity';
+}
+
 export interface DeviceSetNameParams {
   name: string;
 }
@@ -941,6 +993,7 @@ Devices.Location = Location;
 Devices.Packages = Packages;
 Devices.Profile = Profile;
 Devices.Proxy = ProxyAPIProxy;
+Devices.Screenshots = Screenshots;
 Devices.State = State;
 Devices.Tasks = Tasks;
 Devices.Clipboard = Clipboard;
@@ -949,7 +1002,6 @@ Devices.Language = Language;
 Devices.DeepLink = DeepLink;
 Devices.Browser = Browser;
 Devices.Kiosk = Kiosk;
-Devices.MediaSessions = MediaSessions;
 Devices.Recordings = Recordings;
 Devices.TrafficSessions = TrafficSessions;
 
@@ -967,6 +1019,7 @@ export declare namespace Devices {
     type DeviceCreateParams as DeviceCreateParams,
     type DeviceListParams as DeviceListParams,
     type DeviceFingerprintParams as DeviceFingerprintParams,
+    type DeviceResetParams as DeviceResetParams,
     type DeviceSetNameParams as DeviceSetNameParams,
     type DeviceSummaryParams as DeviceSummaryParams,
     type DeviceTerminateParams as DeviceTerminateParams,
@@ -1049,6 +1102,16 @@ export declare namespace Devices {
     type ProxyStatusParams as ProxyStatusParams,
   };
 
+  export {
+    Screenshots as Screenshots,
+    type ScreenshotListResponse as ScreenshotListResponse,
+    type ScreenshotCaptureResponse as ScreenshotCaptureResponse,
+    type ScreenshotListParams as ScreenshotListParams,
+    type ScreenshotDeleteParams as ScreenshotDeleteParams,
+    type ScreenshotCaptureParams as ScreenshotCaptureParams,
+    type ScreenshotImageParams as ScreenshotImageParams,
+  };
+
   export {
     State as State,
     type A11YNode as A11YNode,
@@ -1097,24 +1160,16 @@ export declare namespace Devices {
     type KioskEnableParams as KioskEnableParams,
   };
 
-  export {
-    MediaSessions as MediaSessions,
-    type MediaSessionCreateResponse as MediaSessionCreateResponse,
-    type MediaSessionActivateResponse as MediaSessionActivateResponse,
-    type MediaSessionRetrieveCurrentResponse as MediaSessionRetrieveCurrentResponse,
-    type MediaSessionCreateParams as MediaSessionCreateParams,
-    type MediaSessionDeleteParams as MediaSessionDeleteParams,
-    type MediaSessionActivateParams as MediaSessionActivateParams,
-  };
-
   export {
     Recordings as Recordings,
     type RecordingListResponse as RecordingListResponse,
+    type RecordingScreenshotsResponse as RecordingScreenshotsResponse,
     type RecordingStartResponse as RecordingStartResponse,
     type RecordingStatusResponse as RecordingStatusResponse,
     type RecordingStopResponse as RecordingStopResponse,
     type RecordingListParams as RecordingListParams,
     type RecordingDeleteParams as RecordingDeleteParams,
+    type RecordingScreenshotsParams as RecordingScreenshotsParams,
     type RecordingStartParams as RecordingStartParams,
     type RecordingStatusParams as RecordingStatusParams,
     type RecordingStopParams as RecordingStopParams,

package/src/resources/devices/index.ts

@@ -44,6 +44,7 @@ export {
   type DeviceCreateParams,
   type DeviceListParams,
   type DeviceFingerprintParams,
+  type DeviceResetParams,
   type DeviceSetNameParams,
   type DeviceSummaryParams,
   type DeviceTerminateParams,
@@ -88,15 +89,6 @@ export {
   type LocationResetParams,
   type LocationSetParams,
 } from './location';
-export {
-  MediaSessions,
-  type MediaSessionCreateResponse,
-  type MediaSessionActivateResponse,
-  type MediaSessionRetrieveCurrentResponse,
-  type MediaSessionCreateParams,
-  type MediaSessionDeleteParams,
-  type MediaSessionActivateParams,
-} from './media-sessions';
 export { Packages, type PackageListResponse, type PackageListParams } from './packages';
 export { Profile, type ProfileUpdateParams } from './profile';
 export {
@@ -109,17 +101,28 @@ export {
 export {
   Recordings,
   type RecordingListResponse,
+  type RecordingScreenshotsResponse,
   type RecordingStartResponse,
   type RecordingStatusResponse,
   type RecordingStopResponse,
   type RecordingListParams,
   type RecordingDeleteParams,
+  type RecordingScreenshotsParams,
   type RecordingStartParams,
   type RecordingStatusParams,
   type RecordingStopParams,
   type RecordingTrajectoryParams,
   type RecordingVideoParams,
 } from './recordings';
+export {
+  Screenshots,
+  type ScreenshotListResponse,
+  type ScreenshotCaptureResponse,
+  type ScreenshotListParams,
+  type ScreenshotDeleteParams,
+  type ScreenshotCaptureParams,
+  type ScreenshotImageParams,
+} from './screenshots';
 export {
   State,
   type A11YNode,

package/src/resources/devices/keyboard.ts

@@ -114,12 +114,19 @@ export interface KeyboardWriteParams {
   errorRate?: number;
 
   /**
-   * Body param
+   * Body param: Request human-like input where supported by the device. Defaults to
+   * false.
+   */
+  humanize?: boolean;
+
+  /**
+   * @deprecated Body param: Deprecated: use humanize. Both names must agree when
+   * supplied together.
    */
   stealth?: boolean;
 
   /**
-   * Body param: Words per minute for stealth typing. 0 uses portal default.
+   * Body param: Words per minute for humanized typing. 0 uses the device default.
    */
   wpm?: number;
 

package/src/resources/devices/recordings.ts

@@ -29,6 +29,20 @@ export class Recordings extends APIResource {
     });
   }
 
+  /**
+   * Screenshots saved into the recording with
+   * `GET /devices/{deviceId}/screenshot?save=true`, oldest first, each with a
+   * presigned download URL.
+   */
+  screenshots(
+    recordingID: string,
+    params: RecordingScreenshotsParams,
+    options?: RequestOptions,
+  ): APIPromise<RecordingScreenshotsResponse | null> {
+    const { deviceId } = params;
+    return this._client.get(path`/devices/${deviceId}/recordings/${recordingID}/screenshots`, options);
+  }
+
   /**
    * Start a device recording
    */
@@ -148,6 +162,24 @@ export namespace RecordingListResponse {
   }
 }
 
+export type RecordingScreenshotsResponse =
+  Array<RecordingScreenshotsResponse.RecordingScreenshotsResponseItem>;
+
+export namespace RecordingScreenshotsResponse {
+  export interface RecordingScreenshotsResponseItem {
+    id: string;
+
+    capturedAt: string;
+
+    sizeBytes: number;
+
+    /**
+     * Presigned download URL, valid for 15 minutes.
+     */
+    url: string;
+  }
+}
+
 export interface RecordingStartResponse {
   id: string;
 
@@ -317,23 +349,27 @@ export interface RecordingDeleteParams {
   deviceId: string;
 }
 
+export interface RecordingScreenshotsParams {
+  deviceId: string;
+}
+
 export interface RecordingStartParams {
   name?: string;
 
   /**
    * Capture quality from 1 (lowest) to 10 (full stream quality). Defaults to the
-   * device's full quality. Honored by devices recording through the portal stream
-   * bridge.
+   * device's full quality. Honored only by devices that support adjustable capture
+   * quality.
    */
   quality?: number;
 
   retentionDays?: number;
 
   /**
-   * Artifacts to capture: trajectory (input actions; on portal stream-bridge devices
-   * only when the handset announces trajectory capture), video, and audio (captured
-   * into the video artifact, so it requires video; honored by portal stream-bridge
-   * recorders). Defaults to trajectory and video, narrowed to what the device
+   * Artifacts to capture: trajectory (input actions; on some devices only when the
+   * device announces trajectory capture), video, and audio (captured into the video
+   * artifact, so it requires video; honored only by devices that support audio
+   * capture). Defaults to trajectory and video, narrowed to what the device
    * produces.
    */
   types?: Array<string> | null;
@@ -358,11 +394,13 @@ export interface RecordingVideoParams {
 export declare namespace Recordings {
   export {
     type RecordingListResponse as RecordingListResponse,
+    type RecordingScreenshotsResponse as RecordingScreenshotsResponse,
     type RecordingStartResponse as RecordingStartResponse,
     type RecordingStatusResponse as RecordingStatusResponse,
     type RecordingStopResponse as RecordingStopResponse,
     type RecordingListParams as RecordingListParams,
     type RecordingDeleteParams as RecordingDeleteParams,
+    type RecordingScreenshotsParams as RecordingScreenshotsParams,
     type RecordingStartParams as RecordingStartParams,
     type RecordingStatusParams as RecordingStatusParams,
     type RecordingStopParams as RecordingStopParams,

package/src/resources/devices/screenshots.ts

@@ -0,0 +1,140 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Screenshots extends APIResource {
+  /**
+   * Saved screenshots, newest first. Pass nextCursor as cursor to retrieve the next
+   * page.
+   */
+  list(
+    deviceID: string,
+    query: ScreenshotListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ScreenshotListResponse> {
+    return this._client.get(path`/devices/${deviceID}/screenshots`, { query, ...options });
+  }
+
+  /**
+   * Delete a device screenshot
+   */
+  delete(screenshotID: string, params: ScreenshotDeleteParams, options?: RequestOptions): APIPromise<void> {
+    const { deviceId } = params;
+    return this._client.delete(path`/devices/${deviceId}/screenshots/${screenshotID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Captures the device screen and returns it as a PNG image. Pass save=true to
+   * store it as device media.
+   */
+  capture(
+    deviceID: string,
+    params: ScreenshotCaptureParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<string> {
+    const { hideOverlay, save, 'X-Device-Display-ID': xDeviceDisplayID } = params ?? {};
+    return this._client.post(path`/devices/${deviceID}/screenshots`, {
+      query: { hideOverlay, save },
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xDeviceDisplayID?.toString() != null ?
+            { 'X-Device-Display-ID': xDeviceDisplayID?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Redirects to a presigned PNG URL valid for 15 minutes.
+   */
+  image(screenshotID: string, params: ScreenshotImageParams, options?: RequestOptions): APIPromise<void> {
+    const { deviceId } = params;
+    return this._client.get(path`/devices/${deviceId}/screenshots/${screenshotID}/image`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export interface ScreenshotListResponse {
+  items: Array<ScreenshotListResponse.Item> | null;
+
+  nextCursor: string;
+
+  /**
+   * A URL to the JSON Schema for this object.
+   */
+  $schema?: string;
+}
+
+export namespace ScreenshotListResponse {
+  export interface Item {
+    id: string;
+
+    capturedAt: string;
+
+    deviceId: string;
+
+    expiresAt: string;
+
+    recordingId: string | null;
+
+    sizeBytes: number;
+  }
+}
+
+export type ScreenshotCaptureResponse = string;
+
+export interface ScreenshotListParams {
+  cursor?: string;
+
+  limit?: number;
+}
+
+export interface ScreenshotDeleteParams {
+  deviceId: string;
+}
+
+export interface ScreenshotCaptureParams {
+  /**
+   * Query param
+   */
+  hideOverlay?: boolean;
+
+  /**
+   * Query param: Store the screenshot as device media: in the owner's active
+   * recording, or standalone for 7 days. Without save=true nothing is stored. The
+   * PNG response is unchanged; X-Screenshot-Saved reports whether it was stored.
+   */
+  save?: boolean;
+
+  /**
+   * Header param
+   */
+  'X-Device-Display-ID'?: number;
+}
+
+export interface ScreenshotImageParams {
+  deviceId: string;
+}
+
+export declare namespace Screenshots {
+  export {
+    type ScreenshotListResponse as ScreenshotListResponse,
+    type ScreenshotCaptureResponse as ScreenshotCaptureResponse,
+    type ScreenshotListParams as ScreenshotListParams,
+    type ScreenshotDeleteParams as ScreenshotDeleteParams,
+    type ScreenshotCaptureParams as ScreenshotCaptureParams,
+    type ScreenshotImageParams as ScreenshotImageParams,
+  };
+}

package/src/resources/devices/state.ts

@@ -8,8 +8,11 @@ import { path } from '../../internal/utils/path';
 
 export class State extends APIResource {
   /**
-   * Captures the device screen and returns it as a PNG image. An optional
-   * hideOverlay query parameter excludes the accessibility overlay from the capture.
+   * Deprecated: use POST /devices/{deviceId}/screenshots. Captures the device screen
+   * and returns it as a PNG image. An optional hideOverlay query parameter excludes
+   * the accessibility overlay from the capture.
+   *
+   * @deprecated
    */
   screenshot(
     deviceID: string,
@@ -214,6 +217,13 @@ export interface StateScreenshotParams {
    */
   hideOverlay?: boolean;
 
+  /**
+   * Query param: Store the screenshot as device media: in the owner's active
+   * recording, or standalone for 7 days. Without save=true nothing is stored. The
+   * PNG response is unchanged; X-Screenshot-Saved reports whether it was stored.
+   */
+  save?: boolean;
+
   /**
    * Header param
    */