Get message media

Returns either a hosted URL (url) or inline dataBase64, plus mimetype + filename.

The engine fetches media lazily, so the first call right after a message arrives may still be in flight. By default the server polls up to 6 times (1.5s apart) until the bytes are ready. Pass ?maxAttempts=1 to skip the poll and return immediately (the fast path — useful when you only need the hosted url and can tolerate a retry yourself).

CAVEAT: for own-sent newsletter media (messages you sent to a @newsletter chat), the bytes returned are a WA-generated preview JPEG (~7KB) rather than the original you uploaded — WA releases the original blob from memory immediately after the unencrypted upload. The response will include originalQuality:false when this fallback is in effect; the caller can warn the user or decide to retry from a different source.

Requires chats:read.

curl -X GET "https://api.blueticks.co/v1/messages/media/"

{
  "success": true,
  "data": {
    "url": "string",
    "mimetype": "string",
    "filename": "string",
    "dataBase64": "string",
    "originalQuality": true,
    "mediaUnavailable": "expired"
  }
}

{
  "success": false,
  "error": {
    "code": "string",
    "message": "string",
    "requestId": "string",
    "details": [
      {
        "path": "string",
        "code": "string",
        "message": "string"
      }
    ]
  }
}