> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobileboost.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Device configuration

> Configure and select devices for test execution

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:

```json theme={null}
{
  "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:

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