# Conectar ao ambiente de execução na nuvem

Retorna os dados de conexão de um runtime na nuvem em execução.
- **Pré-requisitos**
: o runtime precisa estar exatamente no estado
`RUNNING`
 e ter sido iniciado por você. Um runtime que está sendo encerrado ou arquivado é rejeitado mesmo que
`/cloudbrowser/page`
 ainda informe
`RUNNING`
.
- **Efeito**
: emite um novo token de acesso ao desktop e registra você como o membro conectado.
- **Chamadas repetidas**
: o
`cdpUrl`
 retornado é estável e as sessões CDP existentes continuam funcionando, mas cada chamada emite um novo token de desktop e sobrescreve o membro conectado registrado.
**As URLs de desktop anteriores não são revogadas**
, então trate cada URL retornada como uma credencial ativa: não registre em logs nem persista.
- **Limite de sessão**
: o runtime é encerrado automaticamente ao atingir sua duração máxima, e o arquivamento começa um pouco antes, então uma automação de longa duração precisa lidar com o desaparecimento do runtime.
- **Uso**
: conecte Puppeteer, Playwright ou Selenium ao
`cdpUrl`
.

Erros de negócio documentados: `40008`, `40009`, `40010`. Consulte [Error Codes](/pt/api-reference/getting-started/error-codes) para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

Endpoint: POST /api/cloudbrowser/connect
Version: 2026-09-05

## 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

