# Redefinir telefone na nuvem

**Aviso de exclusão de dados:** a redefinição apaga dados do telefone e registros de instalação de aplicativos e encerra tarefas de IA. Faça backup dos dados necessários primeiro. É uma operação diferente de criar um novo dispositivo com um clique.
Opera sobre um telefone na nuvem por `id`. É necessária permissão de acesso; o telefone deve estar ativado, não liberado nem em transferência, ligado (`envStatus=4`) e não ocupado por outro membro. O sucesso retorna `data: null`, sem ID de tarefa, e confirma o envio, não a conclusão. Consulte `/api/cloudphone/info` ou `/api/cloudphone/page` com limite de tempo: em processamento é `envStatus=5`, sucesso retorna a `4` e falha no callback passa a `2`. Se houver assinatura, use o resultado final do Webhook `cloud_phone.reset`. Não há chave de idempotência: após um timeout, consulte o estado antes de tentar novamente; outra chamada após a conclusão pode repetir a operação.
Erros de negócio documentados: `33300`, `33301`, `33311`, `33321`, `33325`, `33359`, `33382`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

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)
    Código de resultado retornado: 0: Normal. Outros códigos são exceções.

  - `msg` (string | null, required)
    Mensagem de erro

  - `requestId` (string, required)
    ID da solicitação de operação

  - `data` (null, required)