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, you need to manage the deletion of these temporary assets.

This sample PowerFlow checks periodically for uploaded assets that have been present for a certain amount of time and automatically deletes them.

Learn more about user-generated content.

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
• Iterate Assets: 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 Recurring schedule 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. Learn more about writing search expressions.
5. Specify how many assets a run of the flow should process.

Example cron expressions

Iterate Assets

The Iterate Assets block ensures that the subsequent blocks run for each asset returned by the search.

Steps:

1. Add the Iterate Assets 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 Source of asset list field to Periodic Search Media Resources (use the + icon to insert the variable).

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 it's a video.

Steps:

1. Add the Condition block to your canvas and connect the output of the Iterate Assets 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. In the First variable field, click the + icon to insert a variable. Select Resource type from Iterate Assets.
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. In the First variable field, click the + icon to insert a variable. Select Resource type from Iterate Assets.
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 Use the asset from to Iterate Assets.
7. Set the Recipients to one or more email addresses (separated by commas) that will receive the email.
8. 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 or more of those runs, the flow sends one email per day.
9. Set the Report name to something meaningful to that branch, e.g. Delete UGC Image.
10. 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 Use the asset from to Iterate Assets.
6. 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, click the + icon to insert the Iterate Assets Public id variable.