Media

Endpoints for managing platform media — upload files, fetch media from URLs, and retrieve stored media assets for use in messages

📄️ Upload media

Upload a file to Conversations platform media storage. Returns a media ID and URL that can be referenced in outbound messages via the medias[].id field. The file must not exceed 200 MB. Supported formats: images (JPEG, PNG, GIF, WebP, TIFF, BMP), video (MP4, 3GPP, MPEG, QuickTime), audio (AAC, MP4, MPEG, AMR, OGG, Opus), and documents (PDF, Word, Excel, PowerPoint).

📄️ Fetch media from URL

Download a media file from a public URL and store it in Conversations platform media storage. Returns a media ID and URL that can be used in outbound messages. The file must not exceed 200 MB. Supported MIME types are the same as the upload endpoint.

📄️ Retrieve media

Retrieve a previously stored media file by its media ID. Returns the binary content with appropriate Content-Type headers. Access is restricted to media uploaded by your account.