Reference
Cloud Contracts
Reference for cloud session/action contracts and transport boundaries.
Canonical Session Surface
POST /v1/sessionsGET /v1/sessionsGET /v1/sessions/:sessionIdDELETE /v1/sessions/:sessionIdPOST /v1/sessions/:sessionId/access
Session Create Request
| Field | Type | Required | Notes |
|---|---|---|---|
sourceType | string | No | Session source for auditing and routing. |
name | string | No | Optional session label/namespace hint. |
model | string | No | Optional model label for cloud runtime. |
launchContext | object | No | Optional launch metadata forwarded to runtime. |
launchConfig | object | No | Optional platform launch plan preferences. |
Session Descriptor
| Field | Type | Notes |
|---|---|---|
sessionId | string | Cloud session identifier. |
status | `"provisioning" | "active"` |
baseUrl | string | Canonical semantic session base URL. |
Browser Access Grants
| Field | Type | Notes |
|---|---|---|
capabilities | `("view" | "cdp")[]` |
grants.view | object | Optional attach-only live view websocket grant. |
grants.cdp | object | Optional attach-only CDP websocket grant. |
Supported Cloud Action Methods
clearCacheclearCookiesclickcloseTabdblclickexportCookiesextractextractFromPlangetCookiesgetElementAttributesgetElementBoundingBoxgetElementTextgetElementValuegetHtmlgetTitlegotohoverimportCookiesinputnewTabpressKeyrightclickscreenshotscrollselectsetCookiesnapshotstateswitchTabtabstypeuploadFilewaitForText
Error Codes
CLOUD_ACTION_FAILEDCLOUD_AUTH_FAILEDCLOUD_BILLING_LIMIT_REACHEDCLOUD_BROWSER_PROFILE_BUSYCLOUD_BROWSER_PROFILE_DISABLEDCLOUD_BROWSER_PROFILE_NOT_FOUNDCLOUD_BROWSER_PROFILE_PROXY_UNAVAILABLECLOUD_BROWSER_PROFILE_SYNC_FAILEDCLOUD_CAPACITY_EXHAUSTEDCLOUD_CONTRACT_MISMATCHCLOUD_CONTROL_PLANE_ERRORCLOUD_INTERNALCLOUD_INVALID_REQUESTCLOUD_MODEL_NOT_ALLOWEDCLOUD_PROXY_REQUIREDCLOUD_PROXY_UNAVAILABLECLOUD_RATE_LIMITEDCLOUD_RUNTIME_MISMATCHCLOUD_RUNTIME_UNAVAILABLECLOUD_SESSION_CLOSEDCLOUD_SESSION_NOT_FOUNDCLOUD_SESSION_STALECLOUD_UNSUPPORTED_METHOD
Control API Contract
POST /v1/sessionsGET /v1/sessions/:sessionIdDELETE /v1/sessions/:sessionIdPOST /v1/sessions/:sessionId/accessPOST /selector-cache/import
POST /v1/sessions returns { sessionId, status, baseUrl }.
Attach-only browser grants are issued separately through POST /v1/sessions/:sessionId/access.
Covered Features
api:POST /v1/sessionsapi:POST /v1/sessions/:sessionId/access
