# Subir archivo para la URL

Registra un archivo ya subido para que el Cloud Phone lo descargue.
- **Requisitos previos**: el teléfono debe estar encendido y no puede estar retenido por otro miembro del equipo, y **el objeto ya debe existir en la URL**. Las subidas para transmisión en directo deben ser MP4 y dirigirse a un servicio que admita transmisión.
- **Finalización**: **aceptado, no completado.** La respuesta devuelve `fileId` con estado en curso; consulta `/api/cloudphone/upload/file/result`.
- **Nota sobre la superficie**: es la misma implementación que `/cloudphone/uploadFile` en la Open API. No lo confundas con el flujo multipart más antiguo `/api/cloudphone/uploadFile` de esta superficie.

Errores de negocio documentados: `33401`, `33419`. 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/upload/file
Version: 2026-09-05

## Request fields (application/json):

  - `id` (string, required)
    Cloud phone ID

  - `url` (string, required)
    Upload url, which can be the link returned by the cloudphone/upload/file/signedURL interface or other publicly accessible file download address

  - `uploadDest` (string, required)
    Storage directory

  - `uploadType` (integer)
    File type (1 = regular file, 2 = MP4 live-streaming file)
    Enum: "1", "2"

## Response 200:

  - `200` (unknown)
    Success. `data` is an object with the fields `id`, `fileId` and `status`.

## Response 200 fields (application/json):

  - `code` (integer, required)
    Response code, 0 indicates success,>0 indicates failure

  - `msg` (string | null, required)

  - `data` (object, required)

  - `data.id` (string, required)
    Cloud phone id

  - `data.fileId` (string, required)
    Upload file id

  - `data.status` (integer, required)
    Upload status;0:uploading in progress, 1:upload successful, 2:upload failed

  - `requestId` (string, required)