Skip to main content
POST
/
media
JavaScript
import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: 'My API Key',
});

const response = await client.media.upload({ media_url: 'http://www.example.com/audio.mp3' });

console.log(response.data);
{
  "data": {
    "media_name": "f5586561-8ff0-4291-a0ac-84fe544797bd",
    "expires_at": "2020-01-23T18:10:02.574Z",
    "created_at": "2019-01-23T18:10:02.574Z",
    "updated_at": "2019-01-23T18:10:02.574Z",
    "content_type": "application/xml"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

Upload media request

​
media_url
string
required

The URL where the media to be stored in Telnyx network is currently hosted. The maximum allowed size is 20 MB.

Example:

"http://www.example.com/audio.mp3"

​
ttl_secs
integer

The number of seconds after which the media resource will be deleted, defaults to 2 days. The maximum allowed vale is 630720000, which translates to 20 years.

Example:

86400

​
media_name
string

The unique identifier of a file.

Example:

"my_file"

Response

A response describing a media resource

​
data
Media Resource · object
Example:
{
  "media_name": "f5586561-8ff0-4291-a0ac-84fe544797bd",
  "expires_at": "2020-01-23T18:10:02.574Z",
  "created_at": "2019-01-23T18:10:02.574Z",
  "updated_at": "2019-01-23T18:10:02.574Z",
  "content_type": "application/xml"
}