Media

The Media object represents a single attachment or media file that is associated with a Message.

To simplify sharing of the media files with external applications, the URLs to the files themselves are made publicly accessible. These URLs are random, long and hard to guess, so the contents of the media should stay private unless you choose to distribute the URL. This means that these URLS can be included in any web application to access the files without needing your credentials.

A media object is created when an incoming message is received, or an outgoing message is created, that contain one or more attachments.

The Media Object

A sample media object from the API.

{
  "sid": "b51dc3c6-df20-4af6-b774-a99de20d3fd8",
  "date_created": "Fri, 15 Jun 2018 17:59:25 +0000",
  "date_updated": "Fri, 15 Jun 2018 17:59:25 +0000",
  "account_sid": "446e9986-0848-4d46-a617-48793c5f5e07",
  "parent_sid": "3338f508-c98c-45a1-b2e3-1a2c345477a8",
  "content_type": "image/jpeg",
  "uri": "/api/laml/2010-04-01/Accounts/446e9986-0848-4d46-a617-48793c5f5e07/Messages/3338f508-c98c-45a1-b2e3-1a2c345477a8/Media/b51dc3c6-df20-4af6-b774-a99de20d3fd8.json"
}

Attribute
account_sid string	The unique identifier of the project that sent or received this message.
content_type string	The mime-type of the media file, for example image/gif.
date_created datetime	The date and time the message was sent in RFC 2822 format.
date_updated datetime	The date and time the message was sent in RFC 2822 format.
parent_sid string	The unique identifier of the resource that created this media resource.
sid string	A unique identifier for this media resource.
uri string	The URI for this resource, relative to your base URL.

Media Size Restrictions

All messages, both incoming and outgoing, are limited to 5 MB of associated media files.

Incoming messages with more than 5 MB of media are not accepted.

Outgoing messages are allowed a maximum of 10 Media files. If the total size of all Media is greater than 5 MB, the message will return an error code.