Upload media

Upload media file to Telnyx so it can be used with other Telnyx services

POST /media

JavaScript

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

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

console.log(response.data);

201

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

application/jsonmultipart/form-data

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

201

application/json

A response describing a media resource

data · Media Resource · object

Show child attributes

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