API Reference

Assets

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Serve a file

assets.serve(AssetServeParams**kwargs) -> BinaryResponseContent

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: str

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

minLength1

ReturnsExpand Collapse

BinaryResponseContent

Serve a file

Python

HTTP

TypeScript

Python

Go

CLI Tool

PHP

import os
from beeper_desktop_api import BeeperDesktop

client = BeeperDesktop(
    access_token=os.environ.get("BEEPER_ACCESS_TOKEN"),  # This is the default and can be omitted
)
response = client.assets.serve(
    url="x",
)
print(response)
content = response.read()
print(content)

Returns Examples