---
title: Manage device settings - iOS only
slug: cps-guide/mdm-epmm/manage-device-settings-ios-only
createdAt: 2026-10-06T07:45:20.695Z
---

This API updates specific iOS settings based on the device identifiers in the request. The supported settings are:

- Personal hotspot
- Data roaming

:::hint{type="info"}
Mobile data needs to be switched on in the device to allow enabling of the hotspot. WiFi and Bluetooth are not required for enablement, but for other devices to connect to the hotspot.
:::

The API returns the count of devices for which the settings was successfully updated. The call silently ignores any invalid device identifiers specified in the request.

## HTTP Method

POST

## Request URI

/msa/v1/cps/device/settings

## Request parameters

| Parameter   | Description                                                                                                                                                                                                                                 | Sample Value                                                                                                                                                                                                                                                                                            |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| identifiers | Required<br />Parameter Type: Request body<br />**Data Type:** String<br />List of UEM identifiers in this format:<br />\{<br />"identifiers":\["mdm-id-1", "mdm-id-2"]<br />}<br />See [List of identifiers](docId:0FgXpF4sPOcu6M7eESvy1). | <br />`{`<br />`    "identifiers": [`<br />`        "b9a0d7d05fb4204f52264f805932526b848ca61d"`<br />`     ],  `<br />`    "settings": {`<br />`         "type": "PERSONAL_HOTSPOT",  `<br />`        "value": {`<br />`            "enabled": true`<br />`        }`<br />`    }`<br />`}`<br /><br /> |
| settings    | Required<br />Parameter Type: Request body<br />**Data Type:** String<br />JSON container for the type and value parameters.                                                                                                                | <br />`{`<br />`    "identifiers": [`<br />`        "b9a0d7d05fb4204f52264f805932526b848ca61d"`<br />`     ],  `<br />`    "settings": {`<br />`         "type": "PERSONAL_HOTSPOT",  `<br />`        "value": {`<br />`            "enabled": true`<br />`        }`<br />`    }`<br />`}`<br /><br /> |
| type        | Required<br />Parameter Type: Request body<br />**Data Type:** String<br />The settings to update. Can be:<br />- PERSONAL\_HOTSPOT<br />- DATA\_ROAMING                                                                                    | <br />`{`<br />`    "identifiers": [`<br />`        "b9a0d7d05fb4204f52264f805932526b848ca61d"`<br />`     ],  `<br />`    "settings": {`<br />`         "type": "PERSONAL_HOTSPOT",  `<br />`        "value": {`<br />`            "enabled": true`<br />`        }`<br />`    }`<br />`}`             |
| value       | Required<br />Parameter Type: Request body<br />**Data Type:** String<br />The value to set for the settings. Can be:<br />- true<br />- false                                                                                              | <br />`{`<br />`    "identifiers": [`<br />`        "b9a0d7d05fb4204f52264f805932526b848ca61d"`<br />`     ],  `<br />`    "settings": {`<br />`         "type": "PERSONAL_HOTSPOT",  `<br />`        "value": {`<br />`            "enabled": true`<br />`        }`<br />`    }`<br />`}`             |

## Response fields

API returns the count of devices for which attributes were successfully updated along with HTTP status 200.

See [Number result](docId:0FgXpF4sPOcu6M7eESvy1).

## Example requests

Turn on personal hotspot:

```javascript
POST /msa/v1/cps/device/settings
{
    "identifiers": [
        "b9a0d7d05fb4204f52264f805932526b848ca61d"
    ], 
    "settings": {
        "type": "PERSONAL_HOTSPOT", 
        "value": {
            "enabled": true
        }
    }
}
```

Turn off data roaming:

```javascript
POST /msa/v1/cps/device/settings
{
    "identifiers": [
        "b9a0d7d05fb4204f52264f805932526b848ca61d"
    ], 
    "settings": {
        "type": "DATA_ROAMING", 
        "value": {
            "enabled": false
        }
    }
}
```

## Example response

```javascript
{
    "result": 1
}
```

In case all the identifiers are invalid, then response code will still be 200, with result as 0.