# Request File Upload URL

Request a pre-signed URL for uploading a file that a Cloud Phone will receive.
- **Preconditions**: the phone must be powered on and not held by another member.
- **Effect**: none is persisted — the URL is generated on the fly.
- **Completion**: synchronous. **The pre-signed URL is valid for one hour.** `PUT` the file content to it, then register the upload with the upload endpoint; registering before the object exists is rejected.
- **Note**: uploading the same file name again overwrites the previous object. Temporary objects are removed automatically after 7 days.

Endpoint: POST /cloudphone/uploadUrl
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

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

  - `fileName` (string, required)
    Upload file name

## Response 200:

  - `200` (unknown)
    Success. `data` is an object with the fields `presignedUrl`.

## Response 200 fields (application/json):

  - `code` (integer, required)
    Return result code 0:Normal Other codes are exceptions.

  - `msg` (string | null, required)
    error message

  - `data` (object, required)

  - `data.presignedUrl` (string, required)
    File upload URL use https PUT uploading files to cloud storage

  - `requestId` (string, required)