# Iniciar ambiente de execução na nuvem

Inicia um perfil de navegador como runtime na nuvem.
- **Pré-requisitos**
: o perfil precisa existir na sua equipe e não pode estar criptografado ponta a ponta nem em transferência.
**Um proxy é obrigatório**
 e a acessibilidade dele é verificada antes de o início ser aceito. O kernel do navegador precisa ser um que o navegador na nuvem suporte, o que exclui o Firefox. Os limites de abertura da equipe são aplicados e, em implantações com a cobrança do navegador na nuvem ativada, o saldo de créditos de IA também é verificado.
- **Uma execução por perfil**
: um membro pode ter apenas uma execução ativa por perfil. Quando a equipe ativa o bloqueio de segurança, a execução de outro membro bloqueia a sua.
- **Conclusão**
:
**aceito, não concluído.**

`data`
 está vazio; o runtime é provisionado de forma assíncrona. Consulte
`/cloudbrowser/page`
 até que
`cloudBrowserStatus`
 seja
`RUNNING`
 e depois chame
`/cloudbrowser/connect`
 para obter
`cdpUrl`
. Um início pode ser aceito e falhar depois, o que aparece nessa página.
- **Concorrência**
: inícios simultâneos de um perfil são serializados por um bloqueio; quem perde é rejeitado em vez de entrar na fila.
- **Nova tentativa**
: depois de um timeout, leia
`/cloudbrowser/page`
 — não reenvie.

Erros de negócio documentados: `19039`, `19065`, `40001`, `40003`, `40015`, `40016`, `40021`, `40023`, `40024`, `40025`, `40026`, `40027`, `40028`, `40029`, `40037`. 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/start
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` (null)
    Example: null

