Temporary media uploads

​

What this upload is for

• image
• video
• document
• audio
• voice note

​

Endpoint used by the dashboard

POST /api/media/upload

Authorization: Bearer <jwt_console>

​

Useful response

{
  "data": {
    "id": "med_uuid",
    "url": "https://cdn.example.com/tmp/file.jpg",
    "type": "image",
    "mimeType": "image/jpeg",
    "sizeBytes": 248112,
    "originalName": "visuel.jpg",
    "expiresAt": "2026-04-05T12:00:00.000Z",
    "suggestedMessageType": "image"
  }
}

• url: temporary URL to reuse in mediaUrl
• expiresAt: expiration timestamp
• suggestedMessageType: UI hint for the correct media type

​

Product constraints visible in the dashboard

• the generated link is temporary
• the link may be publicly accessible
• media scheduled after expiresAt may fail to send

​

Product-supported sizes and formats

• image: 5 MB
• document: 10 MB
• video: 16 MB
• audio: 16 MB
• voice note: 16 MB

​

Where this flow is used

• “New message” page
• campaign composer v2 in direct message mode
• voice note recording and upload