API Reference

Assets

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Serve a file

$ beeper-desktop assets serve

GET/v1/assets/serve

Stream a file given an mxc://, localmxc://, or file:// URL. Downloads first if not cached. Supports Range requests for seeking in large files.

ParametersExpand Collapse

--url: string

File URL to serve. Accepts mxc://, localmxc://, or file:// URLs.

ReturnsExpand Collapse

unnamed_schema_0: file path

Serve a file

CLI Tool

HTTP

TypeScript

Python

Go

CLI Tool

PHP

beeper-desktop assets serve \
  --access-token 'My Access Token' \
  --url x

Returns Examples