Advanced
Content reprocessing

Content Reprocessing

Content reprocessing is a critical feature in Fastevo MP2 that allows you to apply updated configurations to your media content. This guide will walk you through the process of initiating content reprocessing and what to expect during this process.

Overview

Reprocessing media content is necessary when changes are made to configurations that affect the output content, such as updating a watermark profile. It is important to note that during the reprocessing period, the content will be temporarily unavailable until the reprocessing is complete.

Callbacks

If callbacks are configured as described in Callbacks, they will be triggered during the reprocessing. The first event you will receive is contentStatusChanged with the status set to queued, indicating that the reprocessing has started.

Justification for Reprocessing

Reprocessing a content must always be justified. Common reasons include:

  • Changes in the watermark profile that affect how the watermark appears on the media.
  • Updates to encoding settings that need to be applied to existing content.

How to Reprocess Content

To reprocess content, you need to make a POST request to the reprocess endpoint. This request can include optional parameters such as the priority level.

Endpoint

POST https://api.fastevo.net/api/v1/projects/mediaProtection/contents/{contentId}/reprocess

Replace {contentId} with the ID of the media content you wish to reprocess.

Request Parameters

  • priority (optional): A numeric value between 0 and 10 that determines the processing priority of the content. This parameter is consistent with the priority setting used in Content creation. It is crucial to set this value smartly if intended to influence the processing order. For example, a priority of 8 indicates a higher processing priority, which can be beneficial when certain content needs to be processed faster relative to others. Note that the effectiveness of setting a higher priority is relative and depends on your customer plan. Setting a higher priority does not guarantee faster processing unless it is supported by your service plan.

Example Request

{
  "priority": 5
}

Handling Responses

Upon successfully initiating the reprocess, the server will respond with a status indicating the success of the request:

{
  "status": 200,
  "data": {
    "success": true
  }
}

Tracking Reprocessing Progress

After initiating reprocessing, it is crucial to track the progress of the content. You can monitor the status changes through the configured Callbacks. The content will transition through various statuses, from queued to processing, and finally to ready when reprocessing is complete.

Conclusion

Reprocessing is a powerful tool in Fastevo MP2 that ensures your media content always reflects the latest configurations and settings. By understanding and utilizing this feature, you can maintain high-quality media outputs that are up-to-date with all changes and enhancements.

ℹ️

Always ensure that the reasons for reprocessing are well-documented and justified to avoid unnecessary disruptions and to maintain the integrity of your media content.

This page provides a comprehensive guide on how to initiate and manage content reprocessing in Fastevo MP2, ensuring your media content remains current and correctly configured.