# Apaga el teléfono en la nube

Detiene un Cloud Phone.
- **Requisitos previos**: el teléfono debe estar arrancando o encendido. No se puede detener mientras esté retenido por otro miembro, ni mientras haya en curso un nuevo dispositivo en un clic, un reinicio o un restablecimiento.
- **Efecto**: detiene la facturación, libera la plaza de concurrencia, liquida el consumo e invalida las credenciales de conexión emitidas para la sesión. Detener un teléfono que todavía estaba arrancando interrumpe el arranque en lugar de apagarlo.
- **Finalización**: la facturación y el estado local se liquidan de forma sincrónica; el apagado del lado del servicio continúa después, así que confírmalo con `/cloudphone/info`.
- **Reintentos**: una segunda llamada informa de que el teléfono no está en ejecución. Los lotes se interrumpen en el primer fallo, así que vuelve a leer el estado antes de reintentar.

Errores de negocio documentados: `33300`, `33301`, `33308`, `33331`, `33332`, `33333`. 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 /cloudphone/powerOff
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `id` (string, required)

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `code` (integer, required)
    Código de resultado devuelto 0: Normal. Los demás códigos son excepciones.

  - `msg` (string | null, required)
    Mensaje de error

  - `requestId` (string, required)
    ID de solicitud de operación