Types of Assets and Correlation to /v2/assets Qualifiers

The /v2/assets route deals with all types of assets.

Note: For more information about Backlot REST API commands, see the Backlot API Reference.

When you create a new asset using the Backlot REST API, the asset_type property in the request body can specify any of the following values.

  • video
  • ad: An ad is simply a video, marked as an ad in the Backlot UI.
  • audio
  • remote_asset
  • youtube: A video destined for YouTube
  • live_stream
  • live_audio
  • channel
  • channel_set

After an asset is created with [POST] /v2/assets (as described in Creating an Asset: POST), in general you can update it in a variety of ways with [PATCH] /v2/assets. See the generalized process in Editing Asset Information: PATCH.

In addition, the /v2/assets route has qualifiers for working with assets in general or specific types of assets, such as associating labels, publishing rules, ad sets, and more. Exact use of these qualifiers is detailed in other sections.

Table 1. /v2/assets Qualifiers by Asset Type
  video ad audio remote_ asset you tube live_ stream live_ audio channel channel_ set
/ad_set X X              
/closed_captions X X X X X X X X X
/drm_attributes X X X X X X X X X
/generated_preview_images X X X            
/labels X X X X X X X X X
/lineup                  
/metadata X X X X X X X X X
/player X X X X X X X X X
/preview_image_files X X X X X X X X X
/preview_image_urls X X X X X X X X X
/primary_preview_image X X X X X X X X X
/publishing_rule X X X X X X X X X
/source_file_info X X X            
/streams X X X            
/upload_status X X X   X        
/uploading_urls X X X   X        
/youtube X     X X        
/replacement X X X   X        

Was this article helpful?