MessageMedia

object

kindrequired: string
image · video · audio · document
mimerequired: string or null
namerequired: string or null
sizerequired: integer or null
captionrequired: string or null
voicerequired: boolean
urlrequired: string or null
Presigned, valid for minutes; null while the file is not stored, or quarantined.
expires_atrequired: DateTime or null
Instant in ISO 8601, e.g. 2026-10-03T04:30:00.000Z.
scanrequired: "pending" | "clean" | "infected" | "not_scanned" | "failed" or null
Malware scan of a document a customer sent (null for photos, audio, video and own uploads). An infected file has no link.

Example

{
  "kind": "string",
  "mime": "string",
  "name": "string",
  "size": 0,
  "caption": "string",
  "voice": true,
  "url": "string",
  "expires_at": "2026-10-06T05:30:00.000Z",
  "scan": "pending"
}