# 重置云手机

**数据清理警告：** 重置会清理手机数据和应用安装记录，并终止正在执行的 AI 任务。请先备份所需数据；该操作不同于一键新机。
通过 `id` 操作单台云手机。调用方须有该手机的操作权限；手机须已激活、未释放、不在转移中、处于开机状态（`envStatus=4`），且未被其他成员占用。成功返回 `data: null`，不返回任务 ID，仅表示提交成功，不表示操作完成。限时轮询 `/cloudphone/info` 或 `/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 /cloudphone/reset
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `id` (string, required)

## Response 200:

  - `200` (unknown)
    好的

## Response 200 fields (application/json):

  - `code` (integer, required)
    返回结果代码 0：正常；其他代码均为例外情况。

  - `msg` (string | null, required)
    错误信息

  - `requestId` (string, required)
    操作请求 ID

  - `data` (null, required)