## Upload

`$client->assets->upload(string file, ?string fileName, ?string mimeType): AssetUploadResponse`

**post** `/v1/assets/upload`

Upload a file to a temporary location using multipart/form-data. Returns an uploadID that can be referenced when sending messages with attachments.

### Parameters

- `file: string`

  The file to upload (max 500 MB).

- `fileName?:optional string`

  Original filename. Defaults to the uploaded file name if omitted

- `mimeType?:optional string`

  MIME type. Auto-detected from magic bytes if omitted

### Returns

- `AssetUploadResponse`

  - `?float duration`

    Duration in seconds (audio/videos)

  - `?string error`

    Error message if upload failed

  - `?string fileName`

    Resolved filename

  - `?float fileSize`

    File size in bytes

  - `?float height`

    Height in pixels (images/videos)

  - `?string mimeType`

    Detected or provided MIME type

  - `?string srcURL`

    Local file URL (file://) for the uploaded asset

  - `?string uploadID`

    Unique upload ID for this asset

  - `?float width`

    Width in pixels (images/videos)

### Example

```php
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

$client = new Client();

$response = $client->assets->upload(
  file: 'file', fileName: 'fileName', mimeType: 'mimeType'
);

var_dump($response);
```