Sign in
App

Upload an asset

Upload a file to a temporary location. Supports JSON body with base64 content field, or multipart/form-data with file field. Returns a local file URL that can be used when sending messages with attachments.

post/v1/assets/upload

Request body

contentstring required

Base64-encoded file content (max ~500MB decoded)

fileNamestring

Original filename. Generated if omitted

mimeTypestring

MIME type. Auto-detected from magic bytes if omitted

Response

Request executed successfully

uploadIDstring

Unique upload ID for this asset

srcURLstring

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

fileNamestring

Resolved filename

mimeTypestring

Detected or provided MIME type

fileSizenumber

File size in bytes

widthnumber

Width in pixels (images/videos)

heightnumber

Height in pixels (images/videos)

durationnumber

Duration in seconds (audio/videos)

errorstring

Error message if upload failed

Changes