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

Browser Retry and Completion Matrix

Retry, idempotency, and completion policy for the 53 Browser operations. 19 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.

Browser Local API

OperationRetry policyIdempotencyCompletion / recovery
POST /api/env/start
startBrowserProfileUsingPOST		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: 19099, 19143.
POST /api/env/close
closeBrowserProfileLocal		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/env/create/quick
createBrowserProfileQuickLocal		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: 14023, 19002, 19063, 19064, 19104, 19106, 19107, 19108, 19111, 19112.
POST /api/env/create/advanced
createBrowserProfileAdvancedLocal		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: 19001, 19002, 19004, 19005, 19063, 19064, 19100, 19101, 19102, 19103, 19104, 19105, 19106, 19107, 19108, 19109, 19110, 19111, 19112, 19141, 19175.
POST /api/env/update
updateBrowserProfileLocal		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: 19001, 19039, 19104, 19105, 19106, 19107, 19108, 19142, 19159, 19160, 19175, 19193.
POST /api/env/removeToRecycleBin/batch
batchDeleteBrowserProfilesUsingPOST		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/env/page
listBrowserProfilesUsingPOST		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/env/detail
getBrowserProfileDetailsUsingPOST		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/env/advanced/ua/versions
listAdvancedUaVersionsLocal		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/env/advanced/ua/get
getBrowserProfileUAUsingPOST		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/env/base/resolution/list
listResolutionsUsingPOST		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/system/platform/list
listSystemPlatformsLocal		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/env/lock/query
queryBrowserLockStatusUsingPOST		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/env/base/list
listTimezoneAndLanguageUsingPOST		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/env/removeLocalCache
clearLocalProfileCacheUsingPOST		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/env/cache/cleanCloud
cleanCloudCacheLocal		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: 19039, 19149.
POST /api/env/fingerprint/refresh
refreshFingerprintUsingPOST		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: 19039, 19104, 19105, 19106, 19107, 19108, 19111, 19142, 19193.
POST /api/env/status
getBrowserProfileStatusLocal		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/env/getAllScreen
getAllBrowserScreensLocal		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/env/arrangeWindows
arrangeBrowserWindowsLocal		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/env/setGroup/batch
setBrowserGroupsBatchLocal		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/env/setProxy/batch
setBrowserProxiesBatchLocal		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, 19106, 19193.
POST /api/env/setRemark/batch
setBrowserRemarksBatchLocal		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/env/closeAll
closeAllBrowserProfilesLocal		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/env/getAllProcessIds
getAllBrowserProcessIdsLocal		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/env/getAllDebugInfo
getAllBrowserDebugInfoLocal		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/env/base/mobile/devices
listMobileDeviceModelsLocal		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/env/core/download
downloadBrowserKernelsLocal		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/cloudbrowser/start
startCloudRuntimeLocal		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 /cloudbrowser/page until the runtime reaches its intended state. Documented business errors: 19039, 19065, 40001, 40003, 40015, 40016, 40021, 40023, 40024, 40025, 40026, 40027, 40028, 40029, 40037.
POST /api/cloudbrowser/stop
stopCloudRuntimeLocal		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 /cloudbrowser/page until the runtime is absent or stopped. Documented business errors: 40002, 40006, 40008, 40020.
POST /api/cloudbrowser/page
pageCloudRuntimesLocal		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/cloudbrowser/connect
connectCloudRuntimeLocal		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: 40008, 40009, 40010.

Browser Open API

OperationRetry policyIdempotencyCompletion / recovery
POST /env/create/quick
quickCreateBrowserProfileOpenApi		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: 14023, 19002, 19063, 19064, 19104, 19106, 19107, 19108, 19111, 19112.
POST /env/create/advanced
advancedCreateBrowserProfileOpenApi		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: 19001, 19002, 19004, 19005, 19063, 19064, 19100, 19101, 19102, 19103, 19104, 19105, 19106, 19107, 19108, 19109, 19110, 19111, 19112, 19141, 19175.
POST /env/update
updateBrowserProfileOpenApi		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: 19001, 19039, 19104, 19105, 19106, 19107, 19108, 19142, 19159, 19160, 19175, 19193.
POST /env/page
listBrowserProfilesOpenApi		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 /env/detail
getBrowserProfileDetailOpenApi		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 /env/removeToRecycleBin/batch
batchRemoveBrowserProfilesOpenApi		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 /env/lock/query
queryBrowserProfileLockOpenApi		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 /env/setGroup/batch
batchSetBrowserProfileGroupOpenApi		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 /env/setProxy/batch
batchSetBrowserProfileProxyOpenApi		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, 19106, 19193.
POST /env/setRemark/batch
batchSetBrowserProfileRemarkOpenApi		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 /cloudbrowser/start
startCloudRuntimeOpenApi		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 /cloudbrowser/page until the runtime reaches its intended state. Documented business errors: 19039, 19065, 40001, 40003, 40015, 40016, 40021, 40023, 40024, 40025, 40026, 40027, 40028, 40029, 40037.
POST /cloudbrowser/stop
stopCloudRuntimeOpenApi		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 /cloudbrowser/page until the runtime is absent or stopped. Documented business errors: 40002, 40006, 40008, 40020.
POST /cloudbrowser/page
pageCloudRuntimesOpenApi		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 /cloudbrowser/connect
connectCloudRuntimeOpenApi		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: 40008, 40009, 40010.
POST /env/advanced/ua/versions
listKernelVersionsOpenApi		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 /env/advanced/ua/get
getUserAgentOpenApi		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 /env/base/resolution/list
listResolutionsOpenApi		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 /env/base/list
listTimezonesAndLanguagesOpenApi		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 /env/base/mobile/devices
listMobileDevicesOpenApi		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 /env/fingerprint/refresh
refreshFingerprintOpenApi		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: 19039, 19104, 19105, 19106, 19107, 19108, 19111, 19142, 19193.
POST /env/cache/cleanCloud
cleanCloudCacheOpenApi		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: 19039, 19149.

Clear cloud profile cache

Overview