# Instala la aplicación en tu teléfono en la nube.

Instala una app de la biblioteca del equipo en un Cloud Phone.
- **Requisitos previos**: el teléfono debe estar encendido y no puede estar retenido por otro miembro del equipo. La app ya debe existir en la biblioteca del equipo o en el catálogo público; identifícala con `appVersionId`, o bien con `packageName` más `versionCode`. Además debe haberse subido al servicio que atiende a este teléfono; de lo contrario la instalación falla.
- **Límite de frecuencia**: como máximo una instalación por teléfono y por segundo; una segunda llamada más rápida se rechaza.
- **Finalización**: **aceptado, no completado.** La respuesta solo confirma que la petición se puso en cola. Consulta `/cloudphone/app/installedList` para ver si la app llegó.
- **Reintentos**: es seguro reintentar tras comprobar la lista de instaladas, respetando el límite de una por segundo.

Errores de negocio documentados: `33005`, `33014`, `33714`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para el significado de cada código. Cualquier operación puede devolver además los códigos comunes.

Endpoint: POST /api/cloudphone/app/install
Version: 2026-09-05

## Request fields (application/json):

  - `appVersionId` (string)
    ID de la versión de la aplicación

  - `id` (string, required)
    ID de teléfono en la nube

  - `packageName` (string)
    Nombre del paquete: solo es necesario si no se proporciona appVersionId.

  - `versionCode` (integer)
    Código de versión: solo es necesario si no se proporciona el appVersionId.

## Response 200:

  - `200` (unknown)
    Correcto. `data` es un único valor booleano.

## Response 200 fields (application/json):

  - `code` (integer)

  - `msg` (string | null)

  - `data` (boolean)

  - `requestId` (string)