# Novo telefone na nuvem com um clique

Substitui a identidade de dispositivo de um Cloud Phone no lugar (novo dispositivo em um clique).
- **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. Se você informar marca e modelo, eles precisam ser suportados pelo SKU do telefone. **Isso consome a cota diária de criação de Cloud Phone**, a mesma usada por `/cloudphone/create`.
- **Efeito**: envia uma nova marca e modelo ao dispositivo, apaga os registros de apps instalados desse telefone, redefine o número de telefone e aborta qualquer tarefa de IA em andamento. O MoreLogin não define o conjunto exato de identificadores que o serviço regenera.
- **Conclusão**: **aceito, não concluído.** O telefone fica em estado de novo dispositivo em um clique; consulte `/cloudphone/info` até que ele saia desse estado.
- **Concorrência**: enquanto roda, ligar, desligar e todos os comandos que exigem um telefone em execução são rejeitados. Uma segunda chamada simultânea é rejeitada em vez de entrar na fila.

Erros de negócio documentados: `33300`, `33301`, `33326`. 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/newMachine
Version: 2026-09-05

## Request fields (application/json):

  - `id` (string)
    ID do telefone na nuvem

  - `brand` (string)
    Marca

  - `modelId` (integer)
    ID do modelo

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `code` (integer, required)
    Código de resposta: 0 indica sucesso, >0 indica falha

  - `msg` (string | null, required)

  - `requestId` (string)
    Identificador único da solicitação; informe-o ao contatar o suporte