Sign in

v10

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-02-242335121.2 KB
App

Download an asset

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

post/v1/assets/download

Request body

urlstring required

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

Example request

{
  "url": "mxc://example.org/Q4x9CqGz1pB3Oa6XgJ"
}

Response

Request executed successfully

srcURLstring

Local file URL to the downloaded asset.

errorstring

Error message if the download failed.