# Executar comando do shell

Executa um comando de shell em um Cloud Phone e retorna a saída.
- **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe.
- **Efeito**: depende inteiramente do comando. O MoreLogin não armazena nada e **não aplica nenhuma lista de comandos permitidos nem limite de tamanho**; os privilégios com que o comando roda são definidos pelo serviço do dispositivo. Ative o root global separadamente se o comando precisar dele.
- **Conclusão**: sincrônica; `data` é a saída do comando, não um identificador de tarefa.
- **Nova tentativa**: não há registro de execução a consultar, então um timeout deixa o resultado desconhecido. Repita apenas comandos que você sabe que é seguro executar duas vezes.

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

## Request fields (application/json):

  - `id` (string, required)
    ID do Cloud Phone

  - `command` (string, required)
    Comando de shell a ser executado

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

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

  - `data` (string, required)
    Informações de resposta

  - `msg` (string | null, required)
    Mensagem de resposta: Uma mensagem de erro será retornada quando o código for maior que 0.

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