Skip to content
Beeper Developer Docs
Download Beeper
API Reference

Assets

Manage assets in Beeper Desktop, like message attachments

Download an asset
assets.download(AssetDownloadParams**kwargs) -> AssetDownloadResponse
POST/v1/assets/download
Upload an asset
assets.upload(AssetUploadParams**kwargs) -> AssetUploadResponse
POST/v1/assets/upload
Upload an asset (base64)
assets.upload_base64(AssetUploadBase64Params**kwargs) -> AssetUploadBase64Response
POST/v1/assets/upload/base64
Serve an asset
assets.serve(AssetServeParams**kwargs)
GET/v1/assets/serve
ModelsExpand Collapse
class AssetDownloadResponse: …
error: Optional[str]

Error message if the download failed.

src_url: Optional[str]

Local file URL to the downloaded asset.

class AssetUploadResponse: …
duration: Optional[float]

Duration in seconds (audio/videos)

error: Optional[str]

Error message if upload failed

file_name: Optional[str]

Resolved filename

file_size: Optional[float]

File size in bytes

height: Optional[float]

Height in pixels (images/videos)

mime_type: Optional[str]

Detected or provided MIME type

src_url: Optional[str]

Local file URL (file://) for the uploaded asset

upload_id: Optional[str]

Unique upload ID for this asset

width: Optional[float]

Width in pixels (images/videos)

class AssetUploadBase64Response: …
duration: Optional[float]

Duration in seconds (audio/videos)

error: Optional[str]

Error message if upload failed

file_name: Optional[str]

Resolved filename

file_size: Optional[float]

File size in bytes

height: Optional[float]

Height in pixels (images/videos)

mime_type: Optional[str]

Detected or provided MIME type

src_url: Optional[str]

Local file URL (file://) for the uploaded asset

upload_id: Optional[str]

Unique upload ID for this asset

width: Optional[float]

Width in pixels (images/videos)