Media

Upload media from base64 data

Upload a file from base64-encoded data. Useful for MCP integrations where the AI has image data but no URL. Accepts images, video, and PDF (a PDF is split into image slides and returned as a carousel — see PdfUploadResult; pass all of media_ids to POST /posts). Max 100MB after decoding; per-platform caps apply at scheduling (Mastodon 99MB, Bluesky 100MB, X 512MB free tier, Threads/Reddit 1GB, Pinterest 2GB, Facebook/Instagram/TikTok 4GB, LinkedIn 5GB, YouTube 256GB).

post/media/upload-from-base64

Request body

datastring required

Base64-encoded file data (without data URI prefix)

mime_typestring required

MIME type of the file (e.g. image/jpeg, image/png, application/pdf)

filenamestring

Optional filename

namestring

Optional human-readable label so the asset is findable by name later (e.g. "pp-play5get50").

folderstring

Optional folder name to file the asset under (created at the top level if missing).

folder_idstring

Optional id of an existing folder to file the asset under.

Response

File uploaded successfully. A single data (Media) for image/video; a PdfUploadResult (slides + media_ids) for a PDF.

Changes

No recorded changes to this endpoint across all 1 revision of this API.