Skip to main content
Use the Media API to upload and manage media files for MMS messages. Plivo supports images, videos, and other media types.

​
The Media Object

​
Attributes

​
media_id
string
A unique identifier for the media file.
​
file_name
string
The name of the uploaded file.
​
content_type
string
The MIME type of the media. Valid types: JPG, PNG, MP4, GIF, PDF, text.
​
media_url
string
The URL of the media file on Plivo’s system.
​
media_size
integer
Size of the media in bytes. Maximum: 2MB per file.
​
upload_time
string
Timestamp when the media was uploaded.
Unused media (not sent in an MMS) is automatically deleted after 6 hours. Media sent in MMS messages is retained for 1 year.

​
Example Media Object

{
  "content_type": "image/jpeg",
  "file_name": "sample.jpg",
  "media_id": "801c2056-33ab-499c-80ef-58b574a462a2",
  "size": 85277,
  "upload_time": "2021-02-17T07:16:09.153289Z",
  "media_url": "https://media.plivo.com/Account/{auth_id}/Media/{media_id}"
}

​
Upload Media

Upload media files to be used in MMS messages. Supports up to 10 attachments per request, with a maximum of 2MB per file. 
POST https://api.plivo.com/v1/Account/{auth_id}/Media/

​
Headers

Set Content-Type to multipart/form-data.

​
Arguments

​
file
file
required
One or more files to upload (max 10 files per request).
import plivo

client = plivo.RestClient('<auth_id>', '<auth_token>')

response = client.media.upload([
    '/path/to/image1.jpg',
    '/path/to/image2.png'
])
print(response)

​
Response

{
  "api_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "objects": [
    {
      "content_type": "image/jpeg",
      "file_name": "image1.jpg",
      "media_id": "801c2056-33ab-499c-80ef-58b574a462a2",
      "size": 85277,
      "status": "success",
      "status_code": 201,
      "upload_time": "2021-02-17T07:16:09.153289Z",
      "media_url": "https://media.plivo.com/Account/{auth_id}/Media/{media_id}"
    }
  ]
}

​
Retrieve Media

Get details of a specific media file by its ID. 
GET https://api.plivo.com/v1/Account/{auth_id}/Media/{media_id}/

​
Arguments

​
media_id
string
required
The unique identifier of the media to retrieve.
import plivo

client = plivo.RestClient('<auth_id>', '<auth_token>')
response = client.media.get('media_id')
print(response)

​
List All Media

Retrieve a paginated list of all uploaded media files. 
GET https://api.plivo.com/v1/Account/{auth_id}/Media/

​
Arguments

​
limit
integer
Number of results per page. Default: 20, Max: 20.
​
offset
integer
Number of records to skip. Default: 0.
import plivo

client = plivo.RestClient('<auth_id>', '<auth_token>')
response = client.media.list(limit=10, offset=0)
print(response)

​
Response

{
  "api_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "meta": {
    "limit": 20,
    "next": null,
    "offset": 0,
    "previous": null,
    "total_count": 2
  },
  "objects": [
    {
      "content_type": "image/jpeg",
      "file_name": "image1.jpg",
      "media_id": "801c2056-33ab-499c-80ef-58b574a462a2",
      "size": 85277,
      "upload_time": "2021-02-17T07:16:09.153289Z",
      "media_url": "https://media.plivo.com/Account/{auth_id}/Media/{media_id}"
    }
  ]
}