Purchase and Activate Monthly Cloud Phones

API Reference

Purchase and Activate Monthly Cloud Phones

Request

Purchase and activate one to ten monthly Cloud Phones for 30 days.

Billing warning: this operation charges the team wallet.
Permission: the calling member must have Fees / Payment Management permission; otherwise the request returns 99012.
Create first: create the phones with /api/cloudphone/create. Creation only provisions inactive records and does not charge.
Selection rules: IDs must be distinct, belong to the team, use active 30-day monthly products and have compatible purchase states. Different monthly SKUs may be purchased together. Mixing paid and unpaid phones, phones from different paid orders, pending client orders or concurrent purchases rejects the entire request.
Charging and restoration: validation and charging are all-or-nothing, so there is no partial charge. If every phone belongs to the same paid order, the server restores the existing paid entitlement and does not charge again. The Local API, Open API and desktop client share the same order state.
Completion: success means every phone was confirmed active for 30 days. It does not power the phones on and does not enable automatic renewal.
Unconfirmed activation: when the service returns 33422, data.results is still complete and preserves request order. Inspect each status, expireTime and errorCode; do not treat the whole result as missing.
Retry: there is no caller-supplied idempotency key. After a timeout, query /api/cloudphone/info or /api/cloudphone/page and inspect billing and expiry state before deciding whether to retry.
Client version: requires MoreLogin desktop client v2.65.0 or later; older clients do not expose this Local API route.

Documented business errors: 20002, 20003, 20004, 20008, 20041, 20055, 20068, 20070, 20071, 33420, 33421, 33422, 99001, 99002, 99012. See Error Codes for what each code means. Any operation can additionally return the common codes.

Client version: requires MoreLogin desktop client v2.65.0 or later; older clients do not expose this Local API route.

Bodyapplication/jsonrequired

idsArray of strings, [ 1 .. 10 ] items, uniquerequired

One to ten distinct positive Cloud Phone IDs, encoded as strings to preserve 64-bit precision

curl -i -X POST \
  http://127.0.0.1:40000/api/cloudphone/monthly/activate \
  -H 'Content-Type: application/json' \
  -d '{
    "ids": [
      "1724032706822188",
      "1724032729890861"
    ]
  }'

Responses

Request processed; inspect code, and inspect data.results when returned

Bodyapplication/json

codeintegerrequired

Business result code; 0 indicates success

Example:0

msgstring or nullrequired

Error message; null when successful

Example:null

requestIdstringrequired

Request ID for troubleshooting

Example:"1d4f3ea968664593860b94b35d4ebf5e"

dataobject(MonthlyCloudPhoneActivationData)

Response

{
  "code": 0,
  "msg": null,
  "data": {
    "orderId": "1724032801202461",
    "orderStatus": 1,
    "results": [ … ]
  },
  "requestId": "db5e04c2eb804cdfb96b1469c7379bbc"
}