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

Запускает профиль браузера как облачную среду выполнения.
- **Предварительные условия**: профиль должен существовать в вашей команде и не должен быть зашифрован сквозным шифрованием или находиться в процессе передачи. **Прокси обязателен**, и его достижимость проверяется до принятия запуска. Ядро браузера должно поддерживаться облачным браузером, что исключает Firefox. Применяются командные лимиты на количество открытых сессий, а в развёртываниях с включённой тарификацией облачного браузера дополнительно проверяется баланс кредитов ИИ.
- **Один запуск на профиль**: у участника может быть только один активный запуск на профиль. Когда команда включает блокировку безопасности, запуск другого участника блокирует ваш.
- **Завершение**: **принято, но не завершено.** `data` пуст; среда выполнения готовится асинхронно. Опрашивайте `/cloudbrowser/page`, пока `cloudBrowserStatus` не станет `RUNNING`, затем вызовите `/cloudbrowser/connect` для получения `cdpUrl`. Запуск может быть принят и всё равно позже провалиться — это отражается на той же странице.
- **Параллелизм**: одновременные запуски одного профиля сериализуются блокировкой; проигравший отклоняется, а не ставится в очередь.
- **Повтор**: после таймаута читайте `/cloudbrowser/page` — не отправляйте запрос повторно.

Задокументированные бизнес-ошибки: `19039`, `19065`, `40001`, `40003`, `40015`, `40016`, `40021`, `40023`, `40024`, `40025`, `40026`, `40027`, `40028`, `40029`, `40037`. Значения кодов см. в [Error Codes](../Getting%20Started/error-codes.md). Любая операция может дополнительно вернуть общие коды.

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