# Parar ambiente de execução na nuvem

Encerra o runtime na nuvem em que um perfil está sendo executado.
- **Pré-requisitos**: precisa existir uma execução ativa iniciada por você para esse perfil. Chamar quando o runtime já está encerrado ou sendo liberado retorna sucesso sem fazer nada.
- **Efeito**: interrompe a cobrança, fecha o consumo, libera o bloqueio do perfil e pede ao cliente que arquive o perfil e os cookies na nuvem antes de o runtime ser liberado.
- **Conclusão**: **aceito, não concluído.** Consulte `/cloudbrowser/page` até que `cloudBrowserStatus` seja `CLOSED` e `cloudBrowserArchiveStatus` chegue a `COMPLETED` ou `FAILED`.
- **Quando o arquivamento falha**: a execução continua faturável e ainda aparece como `RUNNING`. O `force` é considerado **apenas** nesse estado: ele ignora o arquivamento e libera o runtime, o que descarta as alterações de perfil desta sessão.
- **Concorrência**: encerramentos simultâneos de uma mesma execução são serializados, portanto uma chamada duplicada é segura.

Erros de negócio documentados: `40002`, `40006`, `40008`, `40020`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

Endpoint: POST /api/cloudbrowser/stop
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

  - `force` (boolean)
    Whether to forcibly release the cloud runtime. Only takes effect when the current run has
an archive status of `FAILED`; in that case the archive step is skipped and runtime
resources are reclaimed. Ignored in all other cases.
    Example: false

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