# Instale o aplicativo no celular na nuvem.

Instala um app da biblioteca da equipe em um Cloud Phone.
- **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. O app já precisa existir na biblioteca da equipe ou no catálogo público; identifique-o por `appVersionId` ou por `packageName` mais `versionCode`. Ele também precisa ter sido enviado ao serviço que atende este telefone, caso contrário a instalação falha.
- **Limite de taxa**: no máximo uma instalação por telefone por segundo; uma segunda chamada mais rápida é rejeitada.
- **Conclusão**: **aceito, não concluído.** A resposta apenas confirma que a solicitação entrou na fila. Consulte `/cloudphone/app/installedList` para verificar se o app chegou.
- **Nova tentativa**: é seguro repetir depois de verificar a lista de instalados, respeitando o limite de um por segundo.

Erros de negócio documentados: `33005`, `33014`, `33714`. 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/app/install
Version: 2026-09-05

## Request fields (application/json):

  - `appVersionId` (string)
    ID da versão do aplicativo

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

  - `packageName` (string)
    Nome do pacote — obrigatório apenas se appVersionId não for fornecido.

  - `versionCode` (integer)
    Código da versão — necessário apenas se o appVersionId não for fornecido.

## Response 200:

  - `200` (unknown)
    Sucesso. `data` é um único valor booleano.

## Response 200 fields (application/json):

  - `code` (integer)

  - `msg` (string | null)

  - `data` (boolean)

  - `requestId` (string)