# Đặt lại điện thoại đám mây

**Cảnh báo xóa dữ liệu:** đặt lại xóa dữ liệu điện thoại và bản ghi cài đặt ứng dụng, đồng thời dừng tác vụ AI đang chạy. Hãy sao lưu dữ liệu cần thiết trước. Thao tác này khác với tạo thiết bị mới bằng một lần nhấp.
Thao tác trên một điện thoại đám mây theo `id`. Người gọi phải có quyền truy cập; điện thoại phải được kích hoạt, chưa giải phóng, không đang chuyển, đang bật (`envStatus=4`) và không bị thành viên khác chiếm dụng. Thành công trả về `data: null`, không có ID tác vụ và chỉ xác nhận đã gửi, chưa hoàn tất. Thăm dò `/api/cloudphone/info` hoặc `/api/cloudphone/page` trong thời hạn: đang xử lý là `envStatus=5`, thành công trở về `4`, lỗi callback chuyển thành `2`. Nếu đã đăng ký, dùng kết quả cuối từ Webhook `cloud_phone.reset`. Không có khóa idempotency: sau khi hết thời gian chờ, kiểm tra trạng thái trước khi thử lại; gọi lại sau khi hoàn tất có thể thực hiện lần nữa.
Các mã lỗi nghiệp vụ đã ghi nhận: `33300`, `33301`, `33311`, `33321`, `33325`, `33359`, `33382`. Xem [Error Codes](../Getting%20Started/error-codes.md) để biết ý nghĩa từng mã. Mọi thao tác cũng có thể trả về các mã dùng chung.

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)
    Mã trả về 0: Bình thường. Các mã khác là ngoại lệ.

  - `msg` (string | null, required)
    Thông báo lỗi

  - `requestId` (string, required)
    ID yêu cầu vận hành

  - `data` (null, required)