Batch Modify Parameters

Usage Instructions

Batch Modify Cloud Device Parameters, supports powering on up to 20 cloud phones

All optional parameters: If not provided, the corresponding parameter values will not be modified.

Request Instructions

POST /api/v1/cloudPhone/update

Request Parameters

Parameter	Type	Required	Description
images	array	Yes

images

Parameter	Type	Required	Description
image_id	string	Yes	Cloud phone ID
name	string	No	Name
remark	string	No	Remark
proxy	Object	No	Proxy
gps	Object	No	GPS
locale	Object	No	Locale
sim	Object	No	SIM
bluetooth	Object	No	Bluetooth
wifi	Object	No	Wifi
device	Object	No	Device

proxy

Parameter	Type	Required	Description
id	string	No	Proxy ID
dns	integer	No	DNS Status: 1 - Enabled; 2 - Disabled. Default is Enabled

gps

Parameter	Type	Required	Description
type	integer	Yes	1 - Simulate based on proxy IP; 2 - Custom. Default is Custom
longitude	string	No	Longitude, If type is 1, this value does not take effect.
latitude	string	No	Latitude, If type is 1, this value does not take effect.

locale

Parameter	Type	Required	Description
type	integer	No	1 - Simulate based on proxy IP; 2 - Custom. Default is Custom
timezone	string	No	Timezone, If type is 1, this value does not take effect.
language	string	No	Language, If type is 1, this value does not take effect.

sim

Parameter	Type	Required	Description
status	integer	No	Status，1 On；2 Off，Default is On
country	string	No
msisdn	string	No	Complete phone number starting with +
operator	string	No	Operator
mcc	numeric	No
mnc	numeric	No
msin	numeric	No
iccid	numeric	No

bluetooth

Parameter	Type	Required	Description
name	string	No	Bluetooth Name
address	string	No	Bluetooth Address

wifi

Parameter	Type	Required	Description
status	integer	No	Status，1 On；2 Off，Default is On
name	string	No	Wifi Name
mac	string	No
bssid	string	No

device

Parameter	Type	Required	Description
imei	string	No
serialno	string	No
android_id	string	No
name	string	No	Device Name
gsf_id	string	No
gaid	string	No

Note: In Android 10 and Android 11, the gsf_id cannot be directly assigned a specific value. As long as a non-empty value is set, a new value will be automatically regenerated the next time the app is opened.

Request Example

json Copy

{
    "images": [
      {
        "image_id": "xx",
        "name": "xx",
        "remark": "xx",
        "proxy": {
            "id": "xx",
            "dns": 1
        },
        "gps": {
            "type": 2,
            "longitude": 103.775322,
            "latitude": 1.342415
        },
        "locale": {
            "type": 2,
            "timezone": "America/Chicago",
            "language": "en-US"
        },
        "sim": {
            "status": 1,
            "country": "US",
            "msisdn": "+15056447080",
            "operator": "T-Mobile USA",
            "msin": "661024758",
            "iccid": "8912607766605822130",
            "mcc": "310",
            "mnc": "260"
        },
        "bluetooth": {
            "name": "Redmi K30",
            "address": "3d:01:d7:20:fe:28"
        },
        "wifi": {
            "status": 1,
            "name": "Ole-McLaughlin",
            "mac": "F0:17:38:8F:9D:89",
            "bssid": "6b:c1:a2:18:7f:d7"
        },
        "device": {
            "imei": "857942225967646",
            "serialno": "b5c35937",
            "android_id": "4ac56870dc271490",
            "name": "Redmi K30",
            "gsf_id": "3555f0641c1d1421",
            "gaid": "2a4afd02-f4ea-44c3-9678-c27a6b8e506b"
        }
      }
    ]
}

Modify only the proxy request example

json Copy

{
  "image": [
    {
      "image_id": "xx",
      "name": "xx",
      "remark": "xx",
      "proxy": {
          "id": "xx",
          "dns": 1
      },
      "gps": {
          "type": 1 // Simulate based on proxy IP
      },
      "locale": {
          "type": 1 // Simulate based on proxy IP
      }
    }
  ]
}

Response Example

json Copy

{
    "code": 200,
    "data": {
        "success": [ // Successfully cloud phone IDs
            "xx"
        ],
        "fail": [ // Failed cloud phone IDs
            "xx"
        ],
        "fail_reason": {
            "image_id": "xx"
        }
    },
    "message": "Success"
}

Details

Cloud Phone Model List

Last modified: 2025-07-08Powered by

Outline