# Остановить облачную среду выполнения

Останавливает облачную среду выполнения, в которой работает профиль.
- **Предварительные условия**: для этого профиля должен существовать активный запуск, начатый вами. Вызов в момент, когда среда уже остановлена или освобождается, возвращает успех и ничего не делает.
- **Эффект**: прекращает начисление платы, закрывает учёт потребления, снимает блокировку профиля и просит клиент заархивировать профиль и cookie в облако до освобождения среды.
- **Завершение**: **принято, но не завершено.** Опрашивайте `/cloudbrowser/page`, пока `cloudBrowserStatus` не станет `CLOSED`, а `cloudBrowserArchiveStatus` не достигнет `COMPLETED` или `FAILED`.
- **Если архивация не удалась**: запуск остаётся тарифицируемым и по-прежнему отображается как `RUNNING`. `force` учитывается **только** в этом состоянии: он пропускает архивацию и освобождает среду, из-за чего изменения профиля в этой сессии теряются.
- **Параллелизм**: одновременные остановки одного запуска сериализуются, поэтому дублирующий вызов безопасен.

Задокументированные бизнес-ошибки: `40002`, `40006`, `40008`, `40020`. Значения кодов см. в [Error Codes](../Getting%20Started/error-codes.md). Любая операция может дополнительно вернуть общие коды.

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