Skip to content
API Reference
/
/
/
Restart Cloud Phone

Restart Cloud Phone

Request

Restart the entire Cloud Phone. Running AI tasks are terminated and in-progress app installation records are cleared.

Operate on one Cloud Phone by id. The caller must have access to the phone; it must be activated, not released or transferring, powered on (envStatus=4), and not occupied by another member. Success returns data: null with no task ID and means submission succeeded, not completion. Query /api/cloudphone/info or /api/cloudphone/page with bounded polling: processing is envStatus=6, success returns to 4, and callback failure changes it to 2. If subscribed, use the final cloud_phone.restart Webhook result. There is no idempotency key: after a timeout, query state before retrying; another call after completion may execute again.

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

Bodyapplication/jsonrequired
idstringrequired
curl -i -X POST \
  http://127.0.0.1:40000/api/cloudphone/restart \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "1596527092376632"
  }'

Responses

OK

Bodyapplication/json
codeintegerrequired

Return result code 0:Normal Other codes are exceptions.

msgstring or nullrequired

Error message

requestIdstringrequired

Operation Request ID

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