Skip to main content
POST
JavaScript

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: