Skip to content

Enable or disable global ROOT

Request

Turn the global ROOT switch on or off for a Cloud Phone.

  • Preconditions: the phone must be powered on and not held by another member. Supported on compatible device models; on incompatible models the call succeeds but has no effect.
  • Effect: unlike /cloudphone/app/openRoot, the setting is persisted on the phone's settings record and then pushed to the service as a device-wide switch.
  • Completion: synchronous. MoreLogin does not restart the phone; when the change takes effect on the device is device-specific behaviour.
  • Retry: idempotent.

Documented business errors: 33300, 33301. See Error Codes for what each code means. Any operation can additionally return the common codes.

Security
Authorization
Bodyapplication/jsonrequired
idstringrequired

Cloud Phone ID

Example:"1558968155668507"
enableRootbooleanrequired

Whether to enable global system-level ROOT permission

Example:true
curl -i -X POST \
  https://api.morelogin.com/cloudphone/enableRoot \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "1558968155668507",
    "enableRoot": true
  }'

Responses

Success. data is always null for this operation; the outcome is carried by code.

Bodyapplication/json
codeinteger

Response code: 0 = success, >0 = error

datanull
msgstring or null

Message; populated if code > 0

requestIdstring

Unique request identifier; include it when contacting support

Response
{ "code": 0, "data": null, "msg": null, "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d" }