Update Cloud Phone Info

Fresh

WARNING

Do not call this API while starting a cloud phone.

Modify cloud phone name, remark, tags, proxy, group, charge mode, and phone number.

URL: https://openapi.geelark.com/open/v1/phone/detail/updateMethod: POST

Request Parameters

Parameter	Required	Type	Description
id	Yes	string	Cloud phone ID
name	No	string	New name (max 100 chars)
remark	No	string	New remark (max 1500 chars)
groupID	No	string	New group ID
tagIDs	No	array[string]	New tag IDs
proxyConfig	No	object	New proxy configuration
proxyId	No	string	Existing proxy ID
phoneNumber	No	string	Custom phone number (must be shut down)

Static Proxy Config

Parameter	Required	Type	Description
typeId	Yes	integer	1=socks5, 2=http, 3=https
server	Yes	string	Proxy hostname
port	Yes	integer	Proxy port
username	Yes	string	Username
password	Yes	string	Password

Dynamic Proxy Config

typeId	Provider
21	IPHTML
22	kookeey
23	Lumatuo (BrightData)
24	Proxyma
25	SmartProxy
26	RolaIP
27	NodeMaven
29	KookeeyMobile

Request Example

{
  "id": "528086284158239744",
  "name": "api update",
  "remark": "api remark",
  "tagIDs": ["528989565877355520"],
  "groupID": "528995439832269824",
  "proxyConfig": {
    "typeId": 1,
    "server": "123.123.123.123",
    "port": 32080,
    "username": "username",
    "password": "password"
  }
}

Error Codes

Code	Description
42001	Cloud phone does not exist
43022	Tag does not exist
43032	Group does not exist
45003	Proxy region not allowed
45004	Proxy check failed
45008	Proxy type not allowed