# Cloud Phone Retry and Completion Matrix

Retry, idempotency, and completion policy for the 109 Cloud Phone operations. 50 of them document endpoint-specific business error codes.

> For state-changing operations, an HTTP timeout is an unknown outcome—not proof that the operation failed. Query current state before retrying.


See [Endpoint Retry Matrix](/api-reference/getting-started/endpoint-behavior) for the policy definitions and the other products, or the machine-readable [Operation Behavior Manifest](/assets/operation-behavior.c7be57979902d535863b8d6a0eef0e3fb4768f96d388fa815ab123af6ce6038f.ec0bf2e0.yaml).

## Cloud Phone Local API

| Operation | Retry policy | Idempotency | Completion / recovery |
|  --- | --- | --- | --- |
| `GET /api/balance``getAccountAndCloudPhoneQuotasLocal` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `GET /api/cloudphone/monthly/skus``listMonthlyCloudPhoneSkus` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/monthly/activate``activateMonthlyCloudPhones` | Do not retry automatically; first query whether the resource, upload, or task was created. | No public idempotency-key contract is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `20002`, `20003`, `20004`, `20008`, `20041`, `20055`, `20068`, `20070`, `20071`, `33420`, `33421`, `33422`, `99001`, `99002`, `99012`. |
| `POST /api/cloudphone/live/start``startCloudPhoneLiveStreamingLocal` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | Poll POST /cloudphone/live/status; a timeout does not prove that start failed. Documented business errors: `33300`, `33301`, `33401`, `33418`. |
| `POST /api/cloudphone/live/status``getCloudPhoneLiveStreamingStatusLocal` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33401`. |
| `POST /api/cloudphone/live/end``stopCloudPhoneLiveStreamingLocal` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | Poll POST /cloudphone/live/status before repeating the stop request. Documented business errors: `33300`, `33301`, `33401`. |
| `POST /api/cloudphone/uploadFile``fileUploadUsing` | Do not retry automatically; first query whether the resource, upload, or task was created. | No public idempotency-key contract is documented. | Poll POST /cloudphone/uploadFileResult with the returned task identifier. Documented business errors: `33401`, `33419`. |
| `POST /api/cloudphone/upload/file/signedUrl``getCloudPhoneUploadSignedUrlLocal` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/upload/file``uploadCloudPhoneFileByUrlLocal` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33401`, `33419`. |
| `POST /api/cloudphone/upload/file/result``getCloudPhoneUploadResultLocal` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/download``downloadCloudPhoneFileLocal` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | Poll POST /cloudphone/download/result with the returned task identifier. Documented business errors: `33300`, `33301`, `33507`. |
| `POST /api/cloudphone/download/result``getCloudPhoneDownloadResultLocal` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/setKeyBox``setCloudPhoneKeyBoxLocal` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/app/install``installCloudPhoneAppLocal` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | Poll POST /cloudphone/app/installedList before resubmitting installation. Documented business errors: `33005`, `33014`, `33714`. |
| `POST /api/cloudphone/app/page``listCloudPhoneAppsLocal` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/team/app/page``listTeamCloudPhoneAppsLocal` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/app/installedList``listInstalledCloudPhoneAppsLocal` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/app/start``startCloudPhoneAppLocal` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`. |
| `POST /api/cloudphone/app/restart``restartCloudPhoneAppLocal` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/app/stop``stopCloudPhoneAppLocal` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/app/uninstall``uninstallCloudPhoneAppLocal` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`. |
| `POST /api/cloudphone/app/openRoot``appOpenRoot` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`. |
| `POST /api/cloudphone/app/setHideAccessibilityApp``setCloudPhoneAccessibilityAppHiddenLocal` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/page``pageUsingPOST` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/create``createUsingPOST` | Do not retry automatically; first query whether the resource, upload, or task was created. | No public idempotency-key contract is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `19064`, `20018`, `33338`, `33339`, `33340`, `33341`, `33342`, `33343`, `33344`, `33345`, `33398`, `33399`, `33400`, `33408`. |
| `POST /api/cloudphone/powerOn``powerOnUsingPOST` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | Query POST /cloudphone/page before retrying; wait for the reported phone state. Documented business errors: `33300`, `33309`, `33315`, `33316`, `33317`, `33318`, `33321`, `33322`, `33323`, `33324`, `33325`, `33346`, `33347`, `33367`, `33376`, `33407`. |
| `POST /api/cloudphone/powerOff``powerOffUsingPOST` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | Query POST /cloudphone/page before retrying; wait for the reported phone state. Documented business errors: `33300`, `33301`, `33308`, `33331`, `33332`, `33333`. |
| `POST /api/cloudphone/edit/batch``editBatchUsingPOST` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/setProxy``setProxy` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `14023`, `33300`, `33303`, `33320`. |
| `POST /api/cloudphone/delete/batch``deleteUsingPOST` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/newMachine``oneNewUsingPOST` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`, `33326`. |
| `POST /api/cloudphone/info``infoUsingPOST` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/queryByAndroidId``queryByAndroidId` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/enableRoot``enableRoot` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`. |
| `POST /api/cloudphone/screenCap``screenCap` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/screenCapBase64``screenCapBase64` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/brand/models``listCloudPhoneBrandsAndModelsLocal` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/updateAdb``updateAdbUsingPOST` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33350`, `33401`. |
| `POST /api/cloudphone/batchAdbInfo``batchAdbInfo` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/exeCommand``executeShellCommand` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`. |
| `POST /api/cloudphone/rpa/template/market/page``listMarketplaceRpaTemplatesLocal` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/rpa/template/personal/page``listPersonalRpaTemplatesLocal` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/rpa/task/page``listCloudPhoneRpaTasksLocal` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/rpa/task/save``saveCloudPhoneRpaTaskLocal` | Do not retry automatically; first query whether the resource, upload, or task was created. | No public idempotency-key contract is documented. | Observe executions through POST /cloudphone/rpa/subTask/page. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/rpa/onceTask/save``saveCloudPhoneRpaOneTimeTaskLocal` | Do not retry automatically; first query whether the resource, upload, or task was created. | No public idempotency-key contract is documented. | Observe execution through POST /cloudphone/rpa/subTask/page and detail/{id}. Documented business errors: `33814`, `33818`. |
| `POST /api/cloudphone/rpa/task/cancel``cancelCloudPhoneRpaTaskLocal` | Do not retry automatically; first query whether the resource, upload, or task was created. | No public idempotency-key contract is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/rpa/subTask/page``listCloudPhoneRpaSubTasksLocal` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/rpa/subTask/detail/{id}``getCloudPhoneRpaSubTaskDetailLocal` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/rpa/subTask/cancel/{id}``cancelCloudPhoneRpaSubTaskLocal` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /api/cloudphone/touch/click``touchClick` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`, `33401`. |
| `POST /api/cloudphone/touch/doubleClick``touchDoubleClick` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`, `33401`. |
| `POST /api/cloudphone/touch/longClick``touchLongClick` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`, `33401`. |
| `POST /api/cloudphone/touch/swipe``touchSwipe` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`, `33401`. |
| `POST /api/cloudphone/touch/drag``touchDrag` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`, `33401`. |


## Cloud Phone Open API

| Operation | Retry policy | Idempotency | Completion / recovery |
|  --- | --- | --- | --- |
| `GET /balance``getAccountAndCloudPhoneQuotas` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `GET /cloudphone/monthly/skus``listMonthlyCloudPhoneSkus` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/monthly/activate``activateMonthlyCloudPhones` | Do not retry automatically; first query whether the resource, upload, or task was created. | No public idempotency-key contract is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `20002`, `20003`, `20004`, `20008`, `20041`, `20055`, `20068`, `20070`, `20071`, `33420`, `33421`, `33422`, `99001`, `99002`, `99012`. |
| `POST /cloudphone/live/start``startCloudPhoneLiveStreaming` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | Poll POST /cloudphone/live/status; a timeout does not prove that start failed. Documented business errors: `33300`, `33301`, `33401`, `33418`. |
| `POST /cloudphone/live/status``getCloudPhoneLiveStreamingStatus` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33401`. |
| `POST /cloudphone/live/end``stopCloudPhoneLiveStreaming` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | Poll POST /cloudphone/live/status before repeating the stop request. Documented business errors: `33300`, `33301`, `33401`. |
| `POST /oauth2/token``oauth2TokenPost` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `12002`, `35002`, `35005`. |
| `GET /oauth2/userinfo``oauth2UserinfoGet` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/uploadUrl``get` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/uploadFile``fileUploadUsing` | Do not retry automatically; first query whether the resource, upload, or task was created. | No public idempotency-key contract is documented. | Poll POST /cloudphone/uploadFileResult with the returned task identifier. Documented business errors: `33401`, `33419`. |
| `POST /cloudphone/uploadFileResult``fileUploadResult` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/download``cloudphoneDownloadPost` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | Poll POST /cloudphone/download/result with the returned task identifier. Documented business errors: `33300`, `33301`, `33507`. |
| `POST /cloudphone/download/result``cloudphoneDownloadResultPost` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/setKeyBox``cloudphoneSetKeyBoxPost` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/app/install``cloudphoneAppInstallPost` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | Poll POST /cloudphone/app/installedList before resubmitting installation. Documented business errors: `33005`, `33014`, `33714`. |
| `POST /cloudphone/app/page``cloudphoneAppPagePost` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/team/app/page``cloudphoneTeamAppPagePost` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/app/installedList``cloudphoneAppInstalledListPost` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/app/start``cloudphoneAppStartPost` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`. |
| `POST /cloudphone/app/restart``cloudphoneAppRestartPost` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/app/stop``cloudphoneAppStopPost` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/app/uninstall``cloudphoneAppUninstallPost` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`. |
| `POST /cloudphone/app/openRoot``cloudphoneAppOpenRootPost` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`. |
| `POST /cloudphone/app/setHideAccessibilityApp``cloudphoneAppSetHideAccessibilityAppPost` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/page``pageUsingPOST` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/create``createUsingPOST` | Do not retry automatically; first query whether the resource, upload, or task was created. | No public idempotency-key contract is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `19064`, `20018`, `33338`, `33339`, `33340`, `33341`, `33342`, `33343`, `33344`, `33345`, `33398`, `33399`, `33400`, `33408`. |
| `POST /cloudphone/powerOn``powerOnUsingPOST` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | Query POST /cloudphone/page before retrying; wait for the reported phone state. Documented business errors: `33300`, `33309`, `33315`, `33316`, `33317`, `33318`, `33321`, `33322`, `33323`, `33324`, `33325`, `33346`, `33347`, `33367`, `33376`, `33407`. |
| `POST /cloudphone/powerOff``powerOffUsingPOST` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | Query POST /cloudphone/page before retrying; wait for the reported phone state. Documented business errors: `33300`, `33301`, `33308`, `33331`, `33332`, `33333`. |
| `POST /cloudphone/edit/batch``editBatchUsingPOST` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/setProxy``setProxy` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `14023`, `33300`, `33303`, `33320`. |
| `POST /cloudphone/delete/batch``deleteUsingPOST` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/newMachine``oneNewUsingPOST` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`, `33326`. |
| `POST /cloudphone/info``infoUsingPOST` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/queryByAndroidId``queryByAndroidId` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/enableRoot``enableRoot` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`. |
| `POST /cloudphone/screenCap``screenCap` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/screenCapBase64``screenCapBase64` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/brand/models``cloudphoneBrandModelsPost` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/updateAdb``updateAdbUsingPOST` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33350`, `33401`. |
| `POST /cloudphone/batchAdbInfo``batchAdbInfoOpenApi` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/exeCommand``executeShellCommand` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`. |
| `POST /cloudphone/rpa/template/market/page``cloudphoneRpaTemplateMarketPagePost` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/rpa/template/personal/page``cloudphoneRpaTemplatePersonalPagePost` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/rpa/task/page``cloudphoneRpaTaskPagePost` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/rpa/task/save``cloudphoneRpaTaskSavePost` | Do not retry automatically; first query whether the resource, upload, or task was created. | No public idempotency-key contract is documented. | Observe executions through POST /cloudphone/rpa/subTask/page. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/rpa/onceTask/save``cloudphoneRpaOnceTaskSavePost` | Do not retry automatically; first query whether the resource, upload, or task was created. | No public idempotency-key contract is documented. | Observe execution through POST /cloudphone/rpa/subTask/page and detail/{id}. Documented business errors: `33814`, `33818`. |
| `POST /cloudphone/rpa/task/cancel``cloudphoneRpaTaskCancelPost` | Do not retry automatically; first query whether the resource, upload, or task was created. | No public idempotency-key contract is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/rpa/subTask/page``cloudphoneRpaSubTaskPagePost` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/rpa/subTask/detail/{id}``cloudphoneRpaSubTaskDetailIdPost` | Safe with bounded exponential backoff and jitter. | Read-only; repeated requests should not change resource state. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/rpa/subTask/cancel/{id}``cloudphoneRpaSubTaskCancelIdPost` | Query current state before retrying after a timeout or transport failure. | Outcome may already have been applied; repeated execution is not contractually idempotent. | The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract. |
| `POST /cloudphone/touch/click``touchClick` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`, `33401`. |
| `POST /cloudphone/touch/doubleClick``touchDoubleClick` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`, `33401`. |
| `POST /cloudphone/touch/longClick``touchLongClick` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`, `33401`. |
| `POST /cloudphone/touch/swipe``touchSwipe` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`, `33401`. |
| `POST /cloudphone/touch/drag``touchDrag` | Do not retry automatically unless endpoint-specific documentation says it is safe. | No public idempotency guarantee is documented. | The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: `33300`, `33301`, `33401`. |