API Reference

Assets

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Upload an asset

assets.upload(AssetUploadParams**kwargs) -> AssetUploadResponse

POST/v1/assets/upload

Upload a file to a temporary location using multipart/form-data. Returns an uploadID that can be referenced when sending messages with attachments.

ParametersExpand Collapse

file: FileTypes

The file to upload (max 500 MB).

file_name: Optional[str]

Original filename. Defaults to the uploaded file name if omitted

mime_type: Optional[str]

MIME type. Auto-detected from magic bytes if omitted

ReturnsExpand Collapse

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)

Upload an asset

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.upload(
    file=b"Example data",
)
print(response.width)

200 example

{
  "duration": 0,
  "error": "error",
  "fileName": "fileName",
  "fileSize": 0,
  "height": 0,
  "mimeType": "mimeType",
  "srcURL": "srcURL",
  "uploadID": "uploadID",
  "width": 0
}

Returns Examples

200 example

{
  "duration": 0,
  "error": "error",
  "fileName": "fileName",
  "fileSize": 0,
  "height": 0,
  "mimeType": "mimeType",
  "srcURL": "srcURL",
  "uploadID": "uploadID",
  "width": 0
}