A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from https://cloudinary.com/documentation/mediaflows_block_reference below:

PowerFlow block Reference | Documentation

As explained in Build a PowerFlow, PowerFlows are composed of a set of blocks that you connect, creating step-by-step actions to execute. Each block performs a specific function. Blocks are grouped into different categories to make them more accessible.

Triggers

Flows in MediaFlows start with Trigger Blocks, which define how and when a flow is initiated. Triggers can be event-driven (e.g., a webhook call, an asset upload) or time-based (e.g., a scheduled task). Each flow must begin with a trigger block.

Cloudinary Upload

Triggers a flow whenever an asset is uploaded to Cloudinary.

Configuration hints Example use case DAM App

Allows you to trigger flows manually from within the Cloudinary Media Library via the MediaFlows DAM App.

Configuration hints Run the app
  1. Enable the MediaFlows DAM App in Cloudinary's DAM App Marketplace.

  2. Select an asset in Cloudinary's Media Library and click Run MediaFlows from the menu.

  3. Choose the flow to execute.

Example use case

Only MediaFlows users can run DAM Apps (Master Admins and Admins).

Periodic Search Media

Triggers a flow on a predefined schedule by searching for assets that match specific criteria.

Configuration hints Example use case Example cron expressions Scenario AWS cron expression Run every day at 10:00 AM UTC 0 10 * * ? * Run every Monday at 2:00 PM UTC 0 14 ? * MON * Run once per hour 0 * * * ? * Example search expressions Use case Search expression Find all assets in "products" with the tag "spring_collection" folder=products AND tags=spring_collection Find all assets that are of type "video" resource_type=video Scheduler

Executes flows at predefined time intervals, similar to a cron job.

Configuration hints Example use case Example cron expressions Scenario AWS cron expression Run every day at 10:00 AM UTC 0 10 * * ? * Run every Monday at 2:00 PM UTC 0 14 ? * MON * Run once per hour 0 * * * ? * Catch Webhook

Initiates a flow when an HTTP request is received at a specific webhook URL. This allows external applications to trigger flows in MediaFlows.

Configuration hints Example use case Cloudinary Notification

Triggers a flow based on one or more Cloudinary webhook notifications. It's useful for notifications that don't have dedicated trigger blocks already defined, or if you want to set up one trigger for multiple notifications.

Configuration hints Example use case Cloudinary Folder Changed

Triggers a flow when a user moves an asset between folders in Cloudinary.

Configuration hints Example use case On Structured Metadata Change

Triggers a flow when an asset's structured metadata is modified.

Configuration hints Example use case On Tag Change

Triggers a flow when a tag is added to or removed from an asset in Cloudinary.

Configuration hints Example use case Flow logic

These blocks can be used by any flow to implement logical flow functionality.

Complex Condition

Evaluates JSON data against JsonLogic expressions to decide the flow's path.

Configuration hints Example use case Output paths Example JsonLogic Example 1: Check results from AI moderation by prompts Example 2: Check if an image is grayscale Condition

Evaluates a comparison between two variables using a specified operator.

Configuration hints Example use case Output paths Iterate Assets

Executes the next connected blocks on each asset in a list.

If the items in the list aren't Cloudinary assets, use

Iterate List

instead.

Configuration hints Example use case Iterate List

Executes the next connected blocks on each item in a list.

If the items in the list are Cloudinary assets, consider using

Iterate Assets

instead.

Configuration hints Example use case Wait For All

Pauses execution until all block executions following an Iterate List or Iterate Assets block complete.

Configuration hints Example use case Developer tools

These blocks help with debugging, string operations, data shaping, and integration with external APIs.

Add To Logs

Outputs a message in the execution logs, useful for debugging and tracking flow behavior.

Configuration hints Example use case Delay

Pauses the flow for a specified number of seconds.

Configuration hints Example use case Join Strings

Concatenates two strings, optionally using a separator.

Configuration hints Example use case JQ Processor

Processes JSON data using a JQ expression.

Configuration hints Example use cases Example 1: Parse strings and extract product details from a filename Example 2: Calculate an expiration date based on metadata Example 3: Restructure tags into a formatted array JSON To Array

Transforms a JSON object into an array, embedding each original key into its corresponding item. This is especially useful for iterating over objects with the Iterate List block.

Specify a key name to include the original object key as a new property in each array item.

Example input:

With key name set to public_id, the output becomes:

Configuration hints Example use case JSONPath Query

Extracts parts of JSON using a JSONPath expression.

Configuration hints Example use case Parse CSV Asset

Parses a CSV file into an array of objects, with keys from the first row of headers.

CSV files greater than 100 kB are not supported by this block.

Configuration hints Example use case Search And Replace

Replaces parts of a string that match a given string or regex pattern.

Configuration hints Example use cases Send HTTP Request

Sends a request to a third-party API. You can use this block for integrating with external tools like CRMs, PIMs, or marketing platforms.

Configuration hints Example use case

If setting

"Content-Type": "application/x-www-form-urlencoded"

in the Request Headers, you should specify the form fields in the Message Body.

Split String

Divides a string into an array using a defined separator. The output is a list, which you can feed into the Iterate List block.

Configuration hints Example use case Upload Asset To HTTP

Uploads a Cloudinary asset to an external HTTP endpoint using a multipart/form-data request. You can apply optional Cloudinary transformations to the asset before upload and include additional form fields in the request.

Configuration hints Example use case Cloudinary APIs

These blocks interact with Cloudinary's APIs to manage, transform, and retrieve media assets.

Account Usage

Retrieves usage statistics for your Cloudinary account.

Configuration hints Example use case Apply Actions

Prepares eager transformations or performs updates on a Cloudinary asset.

Configuration hints Example use case Example optional parameters

Apply tags to the asset, update the contextual metadata and request quality analysis on the asset.

Change Display Name

Modifies the display name of an asset in Cloudinary.

Configuration hints Example use case Change Public ID

Renames an asset or moves it to a different folder.

For product environments using the legacy

fixed folder mode

, changing the Public ID also changes the delivery URL, and if not done carefully, risks breaking production content.

Configuration hints Example use case Example optional parameters

Specify that a rename should overwrite existing assets with the same public ID, invalidate CDN cached copies of the asset together with all its transformed versions, and change the type to authenticated.

Create Asset URL

Creates a delivery URL for an asset, optionally including a transformation.

Configuration hints Example use case Create Structured Metadata

Creates a structured metadata field for assets.

Configuration hints Example use case Example additional options

Make this metadata field mandatory, and give it a default value of "new".

Delete Media

Deletes an asset from Cloudinary.

Configuration hints Example use case Duplicate Media

Duplicates an asset by calling the upload method of the Upload API to create a copy with a new public ID in the root of the Media Library. Metadata and tags aren't copied.

Configuration hints Example use case Get Asset Information

Fetches details about an asset, such as dimensions and secure URL.

Configuration hints Example use case Get Contextual Metadata

Retrieves a specific contextual metadata value.

Configuration hints Example use case Get Structured Metadata

Retrieves the value of a specific structured metadata field.

Configuration hints

The External ID is usually different than the name of the structured metadata field. You can find it on the Manage Structured Metadata page when selecting a field.

Example use case Get Tags

Retrieves the tags assigned to an asset.

Configuration hints Example use case Image Quality Analysis

Analyzes the quality of an image using Cloudinary's powerful capabilities and returns a comprehensive set of quality indicators, including JPEG quality, focus, noise, contrast, exposure, lighting, color score, resolution, and more.

Configuration hints Example use case

Learn more about Image quality analysis.

Manual Moderation

Sends an asset to manual moderation. You can later review it in the Console to approve or reject it.

Configuration hints Example use case Move To Folder

Moves an asset to a different folder.

For product environments using the legacy

fixed folder mode

, changing the folder also changes the delivery URL, and if not done carefully, risks breaking production content.

Configuration hints Example use case Relate Assets

Relates (or links) two Cloudinary assets.

Configuration hints Example use case

Relate an image with a video showing the same product.

Search Media

Finds assets based on search criteria. The block returns a maximum of 50 results in an array, which you can iterate over using the Iterate Assets block.

Configuration hints Example use case Example search expressions Use case Search expression Find all assets in "products" with the tag "spring_collection" folder=products AND tags=spring_collection Find all assets that are of type "video" resource_type=video Set Access Control

Controls access permissions for an asset. You can either make it publicly accessible, completely restricted, or set up access control based on the access_control parameter of the upload or update methods.

Configuration hints Example use case Example custom JSON

Restrict an asset to require token based access except for the period from 15th December 2022 until 20th January 2024 when it will be publicly available:

Universal API

Calls any Cloudinary API method dynamically. Use this block to call any of the supported Cloudinary API methods when there isn't a dedicated block in MediaFlows that addresses your use case.

To use this block you should be familiar with

Cloudinary's APIs

and understand how to specify parameter methods and values in JSON format.

Configuration hints Example use case Example Method and arguments Example 1: A method with optional parameters only Example 2: A method with required and optional parameters Example 3: The search method

Refer to the

Upload

and

Admin

API references for more details.

Update Contextual Metadata

Updates the contextual metadata of an asset.

Configuration hints Example use case Update Structured Metadata

Updates structured metadata values for an asset.

Configuration hints

The External ID is usually different than the name of the structured metadata field. You can find it on the Manage Structured Metadata page when selecting a field.

Example use case Example metadata values Metadata type Example Explanation Text hello world The text, "hello world". Number 3 The number three. Date 2025-03-25 The date, 25th March 2025. Single-selection list ext_id_one Sets the value corresponding to the external ID of ext_id_one. Multiple-selection list ["ext_id_one", "ext_id_two"] Sets two values corresponding to the external IDs of ext_id_one and ext_id_two. Update Tags

Adds or removes tags from an asset.

Configuration hints Example use case Upload From HTTP

Sends an HTTP request to a target URL, and then automatically uploads the response's media binary to your Cloudinary product environment.

Configuration hints Example use case Upload Media

Uploads an asset from an FTP, HTTP, or HTTPS URL to Cloudinary.

Configuration hints Example use case Example optional parameters

Apply tags and contextual metadata to the asset, and request quality analysis on the asset.

Cloudinary add-ons

These blocks let you enhance your flows using Cloudinary's AI-powered add-ons for tasks like automatic tagging, content analysis, moderation, and more.

AI Content Analysis Get Tags

Use this block to analyze and tag an image using the Cloudinary AI Content Analysis add-on.

Configuration hints Example use case AI Vision Analyze By Prompt

Use this block to analyze an image using an open-ended question or instruction with the Cloudinary AI Vision add-on.

Configuration hints Example use case AI Vision Moderate By Prompts

Use this block to ask up to ten yes/no questions about an image and get structured moderation responses with the Cloudinary AI Vision add-on.

Configuration hints Example use case AI Vision Tag By Prompts

Use this block to generate tags from yes/no prompts and optionally apply the tags to the image with the Cloudinary AI Vision add-on.

Configuration hints Example use case Amazon Image Moderation

Use this block to moderate images for potentially sensitive content with the Amazon Rekognition AI Moderation add-on.

Configuration hints Example use case Cloudinary Image Captioning

Use this block to generate a descriptive caption for an image using the Cloudinary AI Content Analysis add-on.

Configuration hints Example use case Duplicate Image Detection

Use this block to determine if duplicate images exist in your Media Library using the Cloudinary Duplicate Image Detection add-on.

You need to run duplicate detection on the images in your Media Library for them to be included in the search when duplicate detection is run on further images. You can do this in another flow, searching for the images you want to include in the search and running duplicate detection on them. Also see

Specifiying which images are included in the search

.

Configuration hints Example use case Google Image Tagging

Use this block to add tags to an image using the Google Auto Tagging add-on.

Configuration hints Example use case Google Video Tagging

Use this block to add tags to a video using the Google Automatic Video Tagging add-on.

Configuration hints Example use case Integrations

MediaFlows has a number of useful blocks for specific integrations to Cloudinary. If there is an integration that you think should be added then please let us know.

You can use the

Send HTTP Request

block for generic API calls to any integration not listed here.

Akeneo

You can use the Akeneo blocks only with Akeneo versions that support the Akeneo Asset Manager.

Use the Akeneo blocks to communicate with Akeneo's API, to create an asset, delete an asset, or get product information from Akeneo.

You must use a

Get Tokens From Akeneo

block before you can use one of the other Akeneo blocks that requires a valid token. The token returned from the block is valid for any and all Akeneo blocks that follow, so you only need to use the Get Tokens block once for the entire flow that follows.

Get Tokens From Akeneo

Retrieves authentication tokens from Akeneo so that other Akeneo blocks can access the Akeneo API.

Make sure you're registered to Akeneo in order to use this block.

Configuration hints

We recommend that you create a new connection, and use the new credentials to configure this block.

Example use case Create An Asset In Akeneo

Creates an asset in Akeneo's Asset Manager.

To allow this block to communicate with Akeneo's API, you must include a

Get Tokens From Akeneo

block at some point in the flow before this block.

Configuration hints Example use case Example asset values

You can add any additional values as key/values in the Asset Values field. See the Akeneo documentation for more information and examples of passing these values. Note that you only pass the attributes as given in the values key.

The following example passes the photographer and end_of_use_date values:

Example: Configuring a Product Link Rule Delete An Asset In Akeneo

Deletes an asset from Akeneo's Asset Manager.

To allow this block to communicate with Akeneo's API, you must include a

Get Tokens From Akeneo

block at some point in the flow before this block.

Configuration hints Example use case Get Product Information From Akeneo

Fetches product information from Akeneo's Asset Manager using a product UUID.

To allow this block to communicate with Akeneo's API, you must include a

Get Tokens From Akeneo

block at some point in the flow before this block.

Configuration hints Example use case Upload To AWS S3

Uploads a file to an AWS S3 bucket.

Configuration hints Example use case Whitelisting your S3 storage bucket

In order to enable uploading to your bucket, your S3 storage bucket must be whitelisted. This requires the following steps:

  1. Grant full access permissions to Cloudinary's AWS account, using one of the following methods:

  2. Add an empty file to your bucket with your cloud name as the filename, under the following folder structure: .wellknown/cloudinary/<your_cloud_name>

If at a later point you need to update permissions on an existing S3 bucket, changes may take some time to propagate, and you may not see the changes taking effect right away.

Dolby io

Improves media quality using the Dolby.io Media Enhance API.

You need to register to

Dolby.io

in order to use this block.

Configuration hints Example use case Upload To Dropbox

Uploads a file to Dropbox using a URL.

Configuration hints Example use case Set up a Dropbox app

Use this Dropbox OAuth Guide to set up a Dropbox app. The main steps are as follows:

1. Create a Dropbox app:
  1. Head to the App Console and create an app.
  2. Configure the app settings.
  3. Configure the permissions. Ensure you allow read and write access to your files and folders, including the content and metadata.
  4. Submit your configuration.
2. Authorize access to the app, generating an access code:
  1. Navigate to https://www.dropbox.com/oauth2/authorize?client_id=<APP KEY>&response_type=code&token_access_type=offline (replacing <APP KEY> with the App key from the app's settings page).
  2. Copy the access code that's generated.
3. Generate a refresh token:
  1. In a terminal, enter the following command, replacing the placeholders with your information:

  2. Copy the refresh_token from the response.

4. Configure the Upload To Dropbox block:
  1. In the MediaFlows Upload To Dropbox block, set the Dropbox app key and Dropbox app secret with the values from your app settings, and the Dropbox refresh token that you generated.
  2. Test your flow and check that an image is uploaded to your Dropbox.
Google Translate

Translates text from one language to another using the Google Translate API.

You must have a Google Cloud project with the Translation API enabled and a valid API key to use this block.

Configuration hints Example use case InRiver InRiver Add Media From URL

Adds a media resource to InRiver using a URL. You can choose to add it as a hosted external link or upload the actual file. You can also link the asset to a specific entity such as a product.

Configuration hints Example use case InRiver Delete Entity By ID

Deletes an entity from InRiver by providing its ID.

Configuration hints Example use case Mailchimp Upload An Asset To Mailchimp

Uploads an asset to Mailchimp's File Manager.

Configuration hints Example use case Delete An Asset From Mailchimp

Deletes an asset from Mailchimp's File Manager.

Configuration hints Example use case Marketo Create A File

Creates or uploads a file to Marketo using the Marketo API.

Configuration hints Example use case Monday Change Column Value

Updates a column value on a Monday board.

Configuration hints Example use case Example new values

The New Value field requires the new value to be specified as either a string or an object, depending on the column type.

String example

Change the column value to "Done":

Object example

Change the column value to {"label": "Done"}:

Learn more about changing column values.

OpenAI Analyze Image By Prompt

Analyzes an image using OpenAI and answers a question about it.

Configuration hints Example use case Shopify

To use the Shopify blocks you need to create and install a custom app for your Shopify store. This allow access to the Shopify API.

Set up a custom app Upload Image To Shopify

Uploads an image as raw bytes to a Shopify product.

Configuration hints Example use case Update Metafield In Shopify

Updates a metafield value for a Shopify product.

Configuration hints Example use case

If you're intending to deliver your images directly from Cloudinary using delivery URLs in product metafields, you also need to update your Liquid templates. See

Access metafields

.

Update Variant In Shopify

Updates the image of a Shopify product variant or creates a new variant with an image.

Configuration hints Example use case Get Shopify Variant

Fetches a Shopify product variant using a given identifier (e.g. SKU or barcode).

Configuration hints Example use case Notifications

These blocks allow you to send alerts or updates via email, SMS, or messaging platforms like Slack when key events occur in your flow.

Scheduled Email Report

Use this block to schedule a daily email that reports how many assets the flow processed in the last 24 hours, including links to those assets.

Configuration hints Example use case Send Message Using Twilio

Use this block to send an SMS or WhatsApp message using Twilio.

Configuration hints Example use case

You need to be registered with Twilio to use this block.

Send Email Using SendGrid

Use this block to send emails through SendGrid using a dynamic template.

Configuration hints Example use case Send Slack Notification

Send a customized message to Slack using a webhook URL.

Configuration hints Example use case Transformations

These blocks allow you to transform and enhance media in Cloudinary using actions like resize, overlay, effects, and generative AI.

Each of these blocks applies the transformation to the stored image, overwriting the original.

Apply Background

Use this block to fill transparent areas of an image with a solid color or another image.

Configuration hints Example use case Background Removal

Use this block to remove the background from an image.

Configuration hints Example use case Crop Media

Use this block to crop an image or video and focus on a specific region.

Configuration hints Example use case Drop Shadow

Use this block to add realistic shadows to objects in an image.

Configuration hints Example use case Edit Media

Use this block to apply a custom transformation to a media asset using either URL syntax or JSON format.

Configuration hints

If you provide transformations in both URL syntax and object syntax, both are applied - first the string and then the object. We recommend providing just one type of syntax.

Example use case Enhance Image

Use this block to improve the brightness, contrast, and colors of an image using the improve effect.

Configuration hints Example use case Generative Extend

Use this block to expand the dimensions of an image seamlessly with AI-generated pixels.

Configuration hints Example use case Generative Recolor

Use this block to recolor part of an image using AI, while preserving shading and realism.

Configuration hints Example use case Image Overlay

Use this block to place another image over the main asset.

Configuration hints Example use case Optimize Media

Use this block to change an asset's format and quality.

Configuration hints Automatic format

isn't available as it depends on the requesting browser. This block overwrites the original asset, but ideally, you'd store assets in their original format and quality, and deliver them using

automatic format

and

quality

on the fly.

Example use case Resize Media

Use this block to resize a media asset by setting one dimension while keeping the original aspect ratio.

Configuration hints Example use case Text Overlay

Use this block to add styled text onto an image or video.

Configuration hints Example use case

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4