## Download

`assets.download(AssetDownloadParams**kwargs)  -> AssetDownloadResponse`

**post** `/v1/assets/download`

Download a Matrix asset using its mxc:// or localmxc:// URL to the device running Beeper Desktop and return the local file URL.

### Parameters

- `url: str`

  Matrix content URL (mxc:// or localmxc://) for the asset to download.

### Returns

- `class AssetDownloadResponse: …`

  - `error: Optional[str]`

    Error message if the download failed.

  - `src_url: Optional[str]`

    Local file URL to the downloaded asset.

### Example

```python
from beeper_desktop_api import BeeperDesktop

client = BeeperDesktop()
response = client.assets.download(
    url="mxc://example.org/Q4x9CqGz1pB3Oa6XgJ",
)
print(response.error)
```