# Detener entorno de ejecución en la nube

Detiene el runtime en la nube en el que se ejecuta un perfil.
- **Requisitos previos**
: debe existir una ejecución activa iniciada por ti para ese perfil. Llamarlo cuando el runtime ya está detenido o liberándose devuelve éxito sin hacer nada.
- **Efecto**
: detiene la facturación, liquida el consumo, libera el bloqueo del perfil y pide al cliente que archive el perfil y las cookies en la nube antes de liberar el runtime.
- **Finalización**
:
**aceptado, no completado.**
 Consulta
`/cloudbrowser/page`
 hasta que
`cloudBrowserStatus`
 sea
`CLOSED`
 y
`cloudBrowserArchiveStatus`
 llegue a
`COMPLETED`
 o
`FAILED`
.
- **Cuando falla el archivado**
: la ejecución sigue siendo facturable y continúa mostrándose como
`RUNNING`
.
`force`

**solo**
 se tiene en cuenta en ese estado: omite el archivado y libera el runtime, lo que descarta los cambios del perfil de esta sesión.
- **Concurrencia**
: las detenciones simultáneas de una misma ejecución se serializan, por lo que una llamada duplicada es segura.

Errores de negocio documentados: `40002`, `40006`, `40008`, `40020`. Consulte [Error Codes](/es/api-reference/getting-started/error-codes) para el significado de cada código. Cualquier operación puede devolver además los códigos comunes.

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

