Device Interactions

Launch an app on device

Launches an installed app on the device. For iOS, provide the bundleId (e.g., 'com.apple.mobilesafari'). For Android, provide the packageName and optionally the activityName for the main activity. The app must already be installed on the device — use installApp first if needed.

post/sessions/{sessionId}/device/launchApp

Request

Base URL
https://api.us-west-1.saucelabs.com/rdc/v2
Auth
HTTP basic
TypeScript
https://skmtc.dev/saucelabs/apis/real-device-access-api-reference/docs/sessions/:sessionId/device/launchApp/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

sessionIdstring required

The id of the device session

Request body

bundleIdstring

Bundle identifier (iOS)

packageNamestring

Package Name of app to launch (Android)

activityNamestring

Main Activity Name of app to launch (Android)

Example request

{
  "bundleId": "com.apple.XXX",
  "packageName": "com.android.XXX",
  "activityName": "com.android.XXX.Activity"
}

Response

App launched successfully

Changes

No recorded changes to this operation across all 1 revision of this API.