Replacing an Asset

Content replacement enables you to replace old content with new content. For example, you might have a video with technical issues or you might need to change your logo on multiple videos.

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

If the old asset and new asset are nearly identical, replacing content can save you time over deleting the old asset and uploading its replacement—you do not need to update labels, syndication settings, publishing rules, and so on. However, replacing content can affect analytics. For example, if you replace a 5 minute video with a 15 minute video, the average time watched becomes less meaningful and your engagement report will be inaccurate. Content replacement does not create a new movie profile. Instead, the system transcodes a new video file and links it to already existing asset the with same embed code.


Content replacement is intended primarily for use with video assets. If you want to replace content for remote assets or live streams, simply change their settings.

If you are using the default preview images, they are automatically replaced. If you are using a custom preview image (uploaded or via remote URL), it continues to be associated with the new asset.

To replace content:

  1. Use POST with the /v2/assets route, the asset ID, the /replacement qualifier, with properties in the body of the request. The following example replaces the content of the the Y1dTdvMjq9QtOMGrP-H59OIgiZ6-_Mrl asset.
    Note: To upload the entire file at once, do not specify a chunk_size.
       "file_size": 199895,
       "chunk_size": 100000

    Backlot returns a response similar to the following.

       "asset_type": "video",
       "duration": 0,
       "name": "My Video",
       "preview_image_url": null,
       "created_at": "2011-07-22T18:54:19+00:00",
       "embed_code": "Y1dTdvMjq9QtOMGrP-H59OIgiZ6-_Mrl",
       "time_restrictions": null,
       "updated_at": "2011-07-22T18:54:19+00:00",
       "external_id": null,
       "description": null,
       "status": "uploading"
    Note: Try out the code samples using your account credentials in the Ooyala Scratchpad. To launch the Scratchpad, go to Ooyala API Scratchpad. For information about using the Scratchpad, see Practice Making Requests with the Scratchpad.
  2. Retrieve the URLs for uploading your file with GET to the /v2/assets route, the asset ID, the /replacement qualifier, and the /uploading_urls qualifier.
    The URLs are returned in the response body.
  3. Upload each chunk.
    Note: If you didn't specify a chunk_size, do not specify a chunk range.
    The following example uploads the first chunk of the Y1dTdvMjq9QtOMGrP-H59OIgiZ6-_Mrl asset.
  4. Mark the status of the replacement asset as uploaded with the /replacement/upload_status qualifiers.
       "status": "uploaded"

The asset is marked as uploaded. Once processed, it replaces the current asset and becomes live.

Was this article helpful?