Skip to main content
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

FieldDescription
deviceDevice model identifier (e.g., pixel8, iphone15)
osVersionTarget OS version (e.g., 14.0, 17.2)
localeDevice locale (e.g., en_US, de_DE)
platformTarget platform (ios or android)
orientationScreen 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"
    }
  ]
}