# Connect cloud runtime

Return the connection details for a running cloud runtime.
- **Preconditions**: the runtime must be exactly in the `RUNNING` state and must have been started by you. A runtime that is stopping or archiving is rejected even though `/cloudbrowser/page` still reports `RUNNING`.
- **Effect**: mints a fresh desktop access token and records you as the connected member.
- **Repeat calls**: the returned `cdpUrl` is stable and existing CDP sessions keep working, but each call issues a new desktop token and overwrites the recorded connected member. **Earlier desktop URLs are not revoked**, so treat every returned URL as a live credential: do not log or persist them.
- **Session limit**: the runtime is stopped automatically once it reaches its maximum duration, and archiving starts shortly before that, so a long-lived automation run must handle the runtime disappearing.
- **Use**: attach Puppeteer, Playwright or Selenium to `cdpUrl`.

Documented business errors: `40008`, `40009`, `40010`. See [Error Codes](../Getting%20Started/error-codes.md) for what each code means. Any operation can additionally return the common codes.

Endpoint: POST /cloudbrowser/connect
Version: 2026-09-05
Security: OpenApiBearer

## Security:

  - `OpenApiBearer` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `envId` (string, required)
    Browser profile (environment) ID. Serialized as a decimal string to avoid JavaScript
precision loss on 64-bit integers.
    Example: 1800000000000001

## Response 200:

  - `200` (unknown)
    Success

## Response 200 fields (application/json):

  - `code` (integer, required)
    Return result code. `0` means success; other codes indicate exceptions.
    Example: 0

  - `msg` (string | null, required)
    Error message. Usually `null` on success.
    Example: null

  - `requestId` (string)
    Operation request ID. This field may be present when the request passes through the API gateway.
    Example: 1d4f3ea968664593860b94b35d4ebf5e

  - `data` (object, required)

  - `data.cdpUrl` (string, required)
    Full CDP (Chrome DevTools Protocol) address including the access `token` parameter. Pass this
URL to an automation framework such as Puppeteer, Playwright, or Selenium to attach to the
remote browser.
    Example: https://runtime1.morelogin.com:16167?token=c62fedaaac524e41a0f02fc4345d41cb

  - `data.accessUrl` (string | null)
    Cloud browser page wrapper address. Open it in a browser to view and control the cloud
browser desktop. `null` when the page wrapper is not configured.
The `token` parameter is a Base64-encoded payload carrying the desktop URL, desktop token,
expiry, and team, user, member, and environment IDs. The `envName` and `lang` parameters set
the displayed environment name and interface language.
    Example: https://official-website.morelogin.com/browser-remote?token=eyJkZXNrdG9wVXJsIjoi...ZW52SWQiOiIyMDczMzk1NDg5NzM4OTE5OTM2In0%3D&envName=P-1267&lang=en-US