API Reference

Assets

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Download an asset

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 ParametersJSONExpand Collapse

url: string

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

minLength1

ReturnsExpand Collapse

error: optional string

Error message if the download failed.

srcURL: optional string

Local file URL to the downloaded asset.

Download an asset

HTTP

HTTP

TypeScript

Python

Go

CLI Tool

PHP

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

200 example

{
  "error": "error",
  "srcURL": "srcURL"
}

Returns Examples

200 example

{
  "error": "error",
  "srcURL": "srcURL"
}