# クラウドフォンをリセット

**データ削除の警告：** リセットは端末データとアプリインストール記録を削除し、実行中の AI タスクを終了します。必要なデータを先にバックアップしてください。ワンクリック新規端末とは異なる操作です。
`id` で指定した 1 台のクラウドフォンを操作します。操作権限が必要です。有効化済みで、解放済みでも転送中でもなく、起動中（`envStatus=4`）で、他のメンバーに占有されていないことが条件です。成功時は `data: null` を返し、タスク ID は返しません。操作の完了ではなく送信成功を意味します。時間制限付きで `/api/cloudphone/info` または `/api/cloudphone/page` をポーリングしてください。処理中は `envStatus=5`、成功時は `4`、コールバック失敗時は `2` になります。購読済みの場合は `cloud_phone.reset` Webhook の最終結果を利用できます。冪等性キーはありません。タイムアウト後は状態を確認してから再試行してください。完了後の再呼び出しは再実行される場合があります。
文書化されたビジネスエラー: `33300`, `33301`, `33311`, `33321`, `33325`, `33359`, `33382`。 各コードの意味は [Error Codes](../Getting%20Started/error-codes.md) を参照してください。どの操作でも共通コードが返る場合があります。

Endpoint: POST /api/cloudphone/reset
Version: 2026-09-05

## Request fields (application/json):

  - `id` (string, required)

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `code` (integer, required)
    戻り結果コード0：正常。その他のコードは例外です。

  - `msg` (string | null, required)
    エラーメッセージ

  - `requestId` (string, required)
    操作リクエストID

  - `data` (null, required)