## Download

**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.

### Body Parameters

- `url: string`

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

### Returns

- `error: optional string`

  Error message if the download failed.

- `srcURL: optional string`

  Local file URL to the downloaded asset.

### Example

```http
curl http://localhost:23373/v1/assets/download \
    -H 'Content-Type: application/json' \
    -d '{
          "url": "mxc://example.org/Q4x9CqGz1pB3Oa6XgJ"
        }'
```