Skip to content
API Reference
/
/
Retry and Completion Matr...
Last updated

Cloud Phone Retry and Completion Matrix

Retry, idempotency, and completion policy for the 130 Cloud Phone operations. 71 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 for the policy definitions and the other products, or the machine-readable Operation Behavior Manifest.

Cloud Phone Local API

OperationRetry policyIdempotencyCompletion / 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/team/app/delete
deleteTeamCloudPhoneAppLocal		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: 33354.
POST /api/cloudphone/team/app/updateGroup
updateTeamCloudPhoneAppGroupLocal		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: 33354, 33357.
POST /api/cloudphone/team/app/enable
enableTeamCloudPhoneAppLocal		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: 33354, 33369.
POST /api/cloudphone/team/app/updateInstallSetting
updateTeamCloudPhoneAppInstallSettingLocal		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: 33354.
POST /api/cloudphone/team/app/updateEnableRoot
updateTeamCloudPhoneAppEnableRootLocal		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: 33354, 33370.
POST /api/cloudphone/team/app/updateVersion
updateTeamCloudPhoneAppVersionLocal		Query current state before retrying after a timeout or transport failure.Outcome may already have been applied; repeated execution is not contractually idempotent.Saving confirms configuration only. Device application occurs at boot or by asynchronous dispatch; verify the device separately. Documented business errors: 33354, 33368.
POST /api/cloudphone/team/app/updateSetting
updateTeamCloudPhoneAppSettingLocal		Query current state before retrying after a timeout or transport failure.Outcome may already have been applied; repeated execution is not contractually idempotent.Saving confirms configuration only. Device application occurs at boot or by asynchronous dispatch; verify the device separately. Documented business errors: 33354, 33424.
POST /api/cloudphone/team/app/operate
operateTeamCloudPhoneAppLocal		Do not retry automatically unless endpoint-specific documentation says it is safe.No public idempotency guarantee is documented.data=true means the batch loop finished; individual device calls may still have failed. Check each device before retrying. Documented business errors: 33354, 33423, 99002.
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/restart
restartCloudPhone		Query current state before retrying after a timeout or transport failure.Outcome may already have been applied; repeated execution is not contractually idempotent.Submission only. Poll the Cloud Phone info or page operation on the same API surface, or use the subscribed final Webhook result. No task ID is returned. Documented business errors: 33300, 33301, 33310, 33321, 33325, 33359, 33382.
POST /api/cloudphone/reset
resetCloudPhone		Query current state before retrying after a timeout or transport failure.Outcome may already have been applied; repeated execution is not contractually idempotent.Submission only. Poll the Cloud Phone info or page operation on the same API surface, or use the subscribed final Webhook result. No task ID is returned. Documented business errors: 33300, 33301, 33311, 33321, 33325, 33359, 33382.
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

OperationRetry policyIdempotencyCompletion / 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/team/app/delete
deleteTeamCloudPhoneApp		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: 33354.
POST /cloudphone/team/app/updateGroup
updateTeamCloudPhoneAppGroup		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: 33354, 33357.
POST /cloudphone/team/app/enable
enableTeamCloudPhoneApp		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: 33354, 33369.
POST /cloudphone/team/app/updateInstallSetting
updateTeamCloudPhoneAppInstallSetting		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: 33354.
POST /cloudphone/team/app/updateEnableRoot
updateTeamCloudPhoneAppEnableRoot		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: 33354, 33370.
POST /cloudphone/team/app/updateVersion
updateTeamCloudPhoneAppVersion		Query current state before retrying after a timeout or transport failure.Outcome may already have been applied; repeated execution is not contractually idempotent.Saving confirms configuration only. Device application occurs at boot or by asynchronous dispatch; verify the device separately. Documented business errors: 33354, 33368.
POST /cloudphone/team/app/updateSetting
updateTeamCloudPhoneAppSetting		Query current state before retrying after a timeout or transport failure.Outcome may already have been applied; repeated execution is not contractually idempotent.Saving confirms configuration only. Device application occurs at boot or by asynchronous dispatch; verify the device separately. Documented business errors: 33354, 33424.
POST /cloudphone/team/app/operate
operateTeamCloudPhoneApp		Do not retry automatically unless endpoint-specific documentation says it is safe.No public idempotency guarantee is documented.data=true means the batch loop finished; individual device calls may still have failed. Check each device before retrying. Documented business errors: 33354, 33423, 99002.
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/link
createCloudPhoneRemoteLink		Retry with bounded backoff if needed; each successful call creates a new link.Each call creates a new five-minute link without changing the current connection.Open data.url in a browser or encode it as a QR code. Visiting the link requests connection credentials. Documented business errors: 33300, 33301, 99002.
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/restart
restartCloudPhone		Query current state before retrying after a timeout or transport failure.Outcome may already have been applied; repeated execution is not contractually idempotent.Submission only. Poll the Cloud Phone info or page operation on the same API surface, or use the subscribed final Webhook result. No task ID is returned. Documented business errors: 33300, 33301, 33310, 33321, 33325, 33359, 33382.
POST /cloudphone/reset
resetCloudPhone		Query current state before retrying after a timeout or transport failure.Outcome may already have been applied; repeated execution is not contractually idempotent.Submission only. Poll the Cloud Phone info or page operation on the same API surface, or use the subscribed final Webhook result. No task ID is returned. Documented business errors: 33300, 33301, 33311, 33321, 33325, 33359, 33382.
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.

ADB Connection Guide

Overview