API Reference

Assets

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Serve an asset

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.

Query ParametersExpand Collapse

url: string

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

minLength1

Serve an asset

HTTP

HTTP

TypeScript

Python

Go

CLI Tool

PHP

curl http://localhost:23373/v1/assets/serve \
    -H "Authorization: Bearer $BEEPER_ACCESS_TOKEN"

Returns Examples