Device configuration - MobileBoost

By default, tests use your account’s device configurations from the QA Studio. You can override these directly in the execution payload to target specific hardware, OS versions, and locales.

Specifying devices

Pass a deviceConfigs array to define exact device and OS combinations:

{
  "organisationId": "org123",
  "platform": "android",
  "tags": ["critical"],
  "deviceConfigs": [
    {
      "device": "pixel8",
      "osVersion": "14.0",
      "locale": "en_US"
    }
  ]
}

Available fields

Field	Description
`device`	Device model identifier (e.g., `pixel8`, `iphone15`)
`osVersion`	Target OS version (e.g., `14.0`, `17.2`)
`locale`	Device locale (e.g., `en_US`, `de_DE`)
`platform`	Target platform (`ios` or `android`)
`orientation`	Screen orientation

External device providers

If you have configured credentials for a third-party device farm (found under Account Settings > Integrations), you can route test runs to them. Include the deviceProviderSettings object in your payload:

{
  "organisationId": "org123",
  "platform": "android",
  "tags": ["critical"],
  "deviceProviderSettings": {
    "provider": "browserstack"
  },
  "deviceConfigs": [
    {
      "device": "Samsung Galaxy Tab S10 Plus",
      "osVersion": "15.0",
      "locale": "en_US"
    }
  ]
}