Create Asset File

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Asset files contain information needed by creatives.

Please refer to Video Asset File Guide for more information about creating asset files for video creatives.

See request examples.

Asset file types

List of asset files and where they are used as well as parameters type and subtype:

typesubtypeParam where located contentUsed in Creatives
imageurlImage, Video (End Card), Native
htmlurlHTML, Video (End Card)
videouploadurlVideo (by using uploaded video file)
videovast_codesourceVideo (your own VAST code)
videovast_urlurlVideo (Vast code located at url)

Required fields for Image asset files

  • type - must be image
  • name
  • url
  • width
  • height
  • mime (e.g image/jpeg for .jpg, image/png for .png)
  • size_bytes

Image asset files can be used to create Image Create, as Video Creative End Card, Native Creative

Required fields for HTML asset files

  • type - must be html
  • name
  • url - url to html code

HTML asset files can be used to create HTML Creative, Video End Card.

Required fields for Video asset files

There are 3 kinds of Video asset files:

  • upload - Vast XML is generated based on the uploaded video file. See File Upload.
  • vast_code - Asset file is created by given Vast XML code. Should contain MediaFile tag in Vast XML.
  • vast_url - Vast XML code is located at the given url. Should contain MediaFile tag in Vast XML.

Required fields for Video Upload asset files

  • type - must be video
  • subtype - must be upload
  • name
  • url - url to uploaded file by using our upload API.
  • duration
  • mime - mime time of video file, eg. video/mp4
  • size_bytes
  • width
  • height

width, height, duration, mime are required params to create correct MediaFile in Vast.

Video Asset files larger than 10MB will be compressed. You cannot use the asset file to create a creative until it has been compressed.

Required fields for Video Vast Code asset files

  • type - must be video
  • subtype - must be vast_code
  • name
  • source - Vast XML code of asset file.

Required fields for Video URL Code asset files

  • type - must be video
  • subtype - must be vast_url
  • name
  • url - url to Vast XML. It should be accessible by url.
Body Params
string
required

File name of asset file

string
enum
required

Type of asset file

Allowed:
string
enum

Additional subtype for Video asset file

Allowed:
string

URL to uploaded file. Required for all type of asset file except video_code subtype

string

Source of Vast Code when subtype is video_code

string

MIME type of file. E.g. "image/png", "video/mp4". Required for Image and Video Upload asset files.

int32

Width of uploaded file

int32

Height of uploaded file

int32

Size of Uploaded file

int32

Video duration

Response

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json