Delete temporary UGC assets

When you allow users to upload their own content to your product environment for time-bound activities, such as to see how your product looks in their environment, as in the Try before you buy use-case, you need to manage the deletion of these temporary assets.

One way to do this is to use MediaFlows to check periodically for uploaded assets that have been present for a certain amount of time and automatically delete them.

This guide demonstrates how to build a PowerFlow that does just that.

Overview

The PowerFlow uses the following blocks:

• Periodic Search Media: Triggers the flow periodically and runs the rest of the flow for the assets returned by the search
• Apply On Each: Ensures that the subsequent blocks run for each asset returned by the search
• Condition: Checks if the asset is an image or video
• Scheduled Email Report: Includes the asset from its part of the flow in a scheduled daily email
• Delete Media: Deletes the asset from your Cloudinary product environment
• Add To Logs: Writes a message to the log

Periodic Search Media

The Periodic Search Media block triggers the flow periodically and runs the rest of the flow for the assets returned by the search.

Steps:

1. Add the Periodic Search Media block to your canvas.
2. Click the block to edit its settings.
3. Set the AWS cron string according to when you want the flow to trigger. See example cron expressions.
4. Set the Search expression to return the assets you want to delete. For example, to delete assets uploaded over a day ago with the tag ugc-content applied, use the expression: created_at < 1d AND tags:ugc-content.
5. Specify how many assets a run of the flow should process.

Example cron expressions

Apply On Each

The Apply On Each block ensures that the subsequent blocks run for each asset returned by the search.

Steps:

1. Add the Apply On Each block to your canvas and connect the output of the Periodic Search Media block to its input.
2. Click the block to edit its settings.
3. Set the Input List to {{$.Periodic_Search_Media.result.resources}}. You can either type this in the field or select the + button to insert the Resources variable from the Periodic Search Media block.

Condition

There are two Condition blocks in this flow, which lead to three possible branches: one for images, one for videos and one for raw files.

Is it an image?

The first Condition block checks if the asset is an image. If it isn't, the flow moves to the second condition block, which checks if its a video.

Steps:

1. Add the Condition block to your canvas and connect the output of the Apply On Each block to its input.
2. Click the block to edit its settings.
3. Set the name to something meaningful like Is it an image.
4. Set the First variable to {{$.Apply_On_Each.result.item.resource_type}}. You can either type this in the field or select the + button to insert the Item variable from the Apply On Each block, then add .resource_type after item.
5. Set the Operator to equal_to.
6. Set the Second variable to image.
7. Set the Variable type to String.

The top output connector is the path taken if the condition is true (in this case if the resource type is "image"), otherwise the flow continues through the bottom output connector.

Is it a video?

If the asset isn't an image, the flow moves on to check if it's a video.

Steps:

1. Add the Condition block to your canvas and connect the bottom output of the previous Condition block to its input.
2. Click the block to edit its settings.
3. Set the name to something meaningful like Is it a video.
4. Set the First variable to {{$.Apply_On_Each.result.item.resource_type}}. You can either type this in the field or select the + button to insert the Item variable from the Apply On Each block, then add .resource_type after item.
5. Set the Operator to equal_to.
6. Set the Second variable to video.
7. Set the Variable type to String.

If the asset isn't an image or video, the flow presumes that it's a raw file.

Scheduled Email Report

At this point in the flow there are three branches. Add the next three blocks to each of the branches and configure them according to whether the asset is an image, video, or raw file.

The Scheduled Email Report block includes the asset from its branch of the flow in a scheduled daily email.

Steps:

1. Add three Scheduled Email Report blocks to the canvas.
2. Connect the top output of the Is it an image condition block to the input of one.
3. Connect the top output of the Is it a video condition block to the input of the next.
4. Connect the bottom output of the Is it a video condition block to the input of the third.
5. Click each block in turn to edit its settings.
6. Set the Public ID to {{$.Apply_On_Each.result.item.public_id}}. You can either type this in the field or select the + button to insert the Item variable from the Apply On Each block, then add .public_id after item.
7. Set the Delivery Type to upload.
8. Set the Resource Type to image, video or raw, depending on the branch.
9. Set the Recipients to one or more email addresses (separated by commas) that will receive the email.
10. Set the Time to the UTC time at which the email will be sent. If the flow runs three times a day, and this block fires in one of more of those runs, the flow sends one email per day.
11. Set the Report name to something meaningful to that branch, e.g. Delete UGC Image.
12. Set the Description to something meaningful to that branch, e.g. Deleted UGC images.

The email that's sent looks something like this:

Delete Media

The Delete Media block deletes the specified asset from your Cloudinary product environment.

Steps:

1. Add three Delete Media blocks to the canvas.
2. Connect the output of each Scheduled Email Report block to the input of one of these blocks.
3. Click each block in turn to edit its settings.
4. Set the name to something meaningful like Delete Image, Delete Video or Delete Raw.
5. Set the Public ID to {{$.Apply_On_Each.result.item.public_id}}. You can either type this in the field or select the + button to insert the Item variable from the Apply On Each block, then add .public_id after item.
6. Set the Delivery Type to upload.
7. Set the Resource Type to image, video or raw, depending on the branch.
8. Set Invalidate to true to invalidate CDN cached copies of the asset.

Add To Logs

The Add To Logs block writes whatever message you want to the log. In this case, you could record the asset's public ID.

Steps:

1. Add three Add To Logs blocks to the canvas.
2. Connect the output of each Delete Media block to the input of one of these blocks.
3. Click each block in turn to edit its settings.
4. Set the name to something meaningful like Add To Logs Image, Add To Logs Video or Add To Logs Raw.
5. Set the Message to something meaningful. To add the public ID of the deleted asset, use the string {{$.Apply_On_Each.result.item.public_id}}. You can either type this in the field or select the + button to insert the Item variable from the Apply On Each block, then add .public_id after item.