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

Запускає профіль браузера як хмарне середовище виконання.
- **Передумови**
: профіль має існувати у вашій команді й не має бути зашифрований наскрізним шифруванням або перебувати в процесі передавання.
**Проксі обовʼязковий**
, і його досяжність перевіряється до прийняття запуску. Ядро браузера має підтримуватися хмарним браузером, що виключає 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](/uk/api-reference/getting-started/error-codes). Будь-яка операція може додатково повернути загальні коди.

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

