Menu

Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Media Resource

The Media resource represents a piece of media, such as an image, that is associated with a message.

Twilio will create a Media resource and store the contents of the media when the following events occur:

  1. You send a message with an image via Twilio
  2. You receive media on one of your Twilio phone numbers

Twilio will keep that media around until you issue an HTTP DELETE on that instance.

Messages sent via Twilio can include up to 10 media files that have a total size of up to 5MB. Twilio will resize images as necessary for successful delivery based on carrier specifications. Messages with over 5MB of media will not be accepted.

Media properties

account_sid
sid<AC> Not PII

The unique id of the Account responsible for this media.

content_type
string Not PII

The default mime-type of the media, for example image/jpeg, image/png, or image/gif

date_created
date_time<rfc2822> Not PII

The date that this resource was created, given in RFC 2822 format.

date_updated
date_time<rfc2822> Not PII

The date that this resource was last updated, given in RFC 2822 format.

parent_sid
sid<MM> Not PII

The unique id of the resource that created the media.

sid
sid<ME> Not PII

A 34 character string that uniquely identifies this resource.

uri
uri Not PII

The URI for this resource, relative to https://api.twilio.com

Fetch a Media resource

get
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages/{MessageSid}/Media/{Sid}.json

Returns a single media resource using one of several representations:

Default: content-type

Without an extension, the media is returned using the mime-type provided when the media was generated.

GET /2010-04-01/Accounts/AC.../Message/MM.../Media/ME557ce644e5ab84fa21cc21112e22c485

Alternative: XML

Appending ".xml" to the URI returns a familiar XML representation. For example:

GET /2010-04-01/Accounts/AC.../Message/MM.../Media/ME557ce644e5ab84fa21cc21112e22c485.xml
<TwilioResponse>
 <Media>
   <Sid>ME557ce644e5ab84fa21cc21112e22c485</Sid>
   <AccountSid>ACda6f1e11047ebd6fe7a55f120be3a900</AccountSid>
   <ParentSid>MM8dfedb55c129dd4d6bd1f59af9d11080</ParentSid>
   <ContentType>image/jpeg</ContentType>
   <DateCreated>Fri, 17 Jul 2009 01:52:49 +0000</DateCreated>
   <DateUpdated>Fri, 17 Jul 2009 01:52:49 +0000</DateUpdated>
   <Uri>/2010-04-01/Accounts/ACda6f1e11047ebd6fe7a55f120be3a900/Message/MM8dfedb55c129dd4d6bd1f59af9d11080/Media/ME557ce644e5ab84fa21cc21112e22c485.xml</Uri>
 </Media>
</TwilioResponse>

Alternative: JSON

Appending ".json" to the URI returns a familiar JSON representation. For example:

GET /2010-04-01/Accounts/AC.../Message/MM.../Media/ME557ce644e5ab84fa21cc21112e22c485.json
{
    "sid": "ME557ce644e5ab84fa21cc21112e22c485",
    "account_sid": "ACda6f1e11047ebd6fe7a55f120be3a900",
    "parent_sid": "MM8ff928b2451c0db925bd2d581f0fba79",
    "content_type": "image/jpeg",
    "date_created": "Fri, 26 Apr 2013 05:41:35 +0000",
    "date_updated": "Fri, 26 Apr 2013 05:41:35 +0000",
    "uri": "/2010-04-01/Accounts/ACda6f1e11047ebd6fe7a55f120be3a900/Message/MM8dfedb55c129dd4d6bd1f59af9d11080/Media/ME557ce644e5ab84fa21cc21112e22c485.json"
}
Parameters
Sid
Required
get sid<ME> Not PII

The media Sid that uniquely identifies this resource

Example
Loading Code Sample...
      
      
      
      

      Because the stored media URLs are useful for many external applications, they are public and do not require HTTP Basic Auth to access. This allows you to embed the URL in a web application without revealing your Twilio API credentials.

      These URLs are long and hard to guess, so the contents of the media should be private unless you choose to distribute the URL.

      Read multiple Media resources

      get
      https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages/{MessageSid}/Media.json

      Returns a list of media associated with your message. The list includes paging information.

      Filter by date created

      You may limit the list of Message Media to media created on a given date. Provide the following query string parameter to your API call:

      Parameters
      DateCreated
      Optional
      get date_time_inequality<iso8601> Not PII

      Only show media created on the given date. Should be formatted as YYYY-MM-DD. You can also specify inequality, such as DateCreated<=YYYY-MM-DD for media generated at or before midnight on a date, and DateCreated>=YYYY-MM-DD for media generated at or after midnight on a date.

      Example 1
      Loading Code Sample...
          
          
          
          
          Return the list of media associated with your message

          Read Media

          Return the list of media associated with your message

          Delete a Media resource

          delete
          https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages/{MessageSid}/Media/{Sid}.json

          Deletes Media from your account.

          If successful, returns HTTP 204 (No Content) with no body.

          Parameters
          Sid
          Required
          delete sid<ME> Not PII

          The media Sid that uniquely identifies this resource

          Example 1
          Loading Code Sample...
              
              
              
              

              Need some help?

              We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.

              Loading Code Sample...