# Зупинити хмарне середовище виконання

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

Задокументовані бізнес-помилки: `40002`, `40006`, `40008`, `40020`. Значення кодів див. у [Error Codes](/uk/api-reference/getting-started/error-codes). Будь-яка операція може додатково повернути загальні коди.

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

