# クラウドランタイムを起動

ブラウザープロファイルをクラウドランタイムとして起動します。
- **前提条件**：プロファイルが自チームに存在し、エンドツーエンド暗号化されておらず、移管中でもないこと。**プロキシが必須**で、起動が受理される前にその到達性が検査されます。ブラウザーカーネルはクラウドブラウザーが対応するものでなければならず、これにより Firefox は除外されます。チームの同時オープン上限が適用され、クラウドブラウザー課金が有効な環境では AI クレジット残高も検査されます。
- **1 プロファイルに 1 実行**：1 人のメンバーが 1 プロファイルにつき保持できる実行は 1 つだけです。チームがセキュリティロックを有効にしている場合、他のメンバーの実行が自分の起動を妨げます。
- **完了シグナル**：**受理されただけで、完了ではありません。** `data` は空です。ランタイムは非同期に用意されます。`/cloudbrowser/page` をポーリングし `cloudBrowserStatus` が `RUNNING` になったら、`/cloudbrowser/connect` を呼んで `cdpUrl` を取得してください。起動が受理された後に失敗することもあり、その場合はそのページに現れます。
- **同時実行**：1 プロファイルへの同時起動はロックで直列化され、競合に負けた側はキューに入らず拒否されます。
- **リトライ**：タイムアウト後は `/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