Retrieve a media object

Use this endpoint for the Media method to retrieve a single media record.

A media object can be returned in several representations:

• Direct Media: Without specifying an extension, the media is returned directly using the mime-type detected.

• JSON: By appending .json to the media URL, the JSON representation of the media will be returned.

---

Parameters

Parameter
No Parameters

---

Request

In this example, we will retrieve a Media instance as its JSON representation.

cURL

curl https://example.signalwire.com/api/laml/2010-04-01/Accounts/{AccountSid}/Messages/{MessageSid}/Media/{MediaSid}.json \
  -X GET \
  -u "YourProjectID:YourAuthToken"

Node.js

const { RestClient } = require('@signalwire/compatibility-api')
const client = RestClient('YourProjectID', 'YourAuthToken', { signalwireSpaceUrl: 'example.signalwire.com' })

client.messages('MessageSid')
      .media('MediaSid')
      .fetch()
      .then(media => console.log(media.contentType))
      .done();

C#

using System;
using System.Collections.Generic;
using Twilio;
using Twilio.Rest.Api.V2010.Account.Message;

class Program
{
    static void Main(string[] args)
    {
        TwilioClient.Init("YourProjectID", "YourAuthToken", new Dictionary<string, object> { ["signalwireSpaceUrl"] = "{SPACE}.signalwire.com" });

        var media = MediaResource.Fetch(
            pathMessageSid: "MessageSid",
            pathSid: "MediaSid"
        );

        Console.WriteLine(media.ContentType);
    }
}

Python

from signalwire.rest import Client as signalwire_client

client = signalwire_client("YourProjectID", "YourAuthToken", signalwire_space_url = 'example.signalwire.com')

media = client.messages('MessageSid') \
              .media('MediaSid') \
              .fetch()

print(media.content_type)

Ruby

require 'signalwire/sdk'

@client = Signalwire::REST::Client.new 'YourProjectID', 'YourAuthToken', signalwire_space_url: "example.signalwire.com"

media = @client.messages('MessageSid')
               .media('MediaSid')
               .fetch

puts media.content_type

---

Responses

200 OK

{
  "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"
}