Cloudinary

Integrate Cloudinary with your AI workspace

Cloudinary is a cloud-based media management platform for uploading, storing, transforming, and delivering images and videos via CDN.

Explore Triggers and Actions

Activate Live Stream

Tool to manually activate a Cloudinary live stream. Use when you need to start a live stream that is in an inactive state.

ActionTry it

Create Asset Relations by Asset ID

Tool to add related assets by asset ID. Use when you need to create relationships between assets in Cloudinary. Can relate up to 10 assets at once to a source asset.

ActionTry it

Create Asset Relations by Public ID

Tool to create relations between assets by public ID. Use when you need to link related assets together (e.g., linking subtitles to videos, or associating images with each other). Each request can relate up to 10 assets to the primary asset.

ActionTry it

Create Folder

Tool to create a new asset folder. Use when you need to organize assets into nested directories. Use after confirming the folder path does not already exist.

ActionTry it

Create Image from Text

Tool to create an image from text using Cloudinary's text generation API. Use when you need to generate custom text images with specific styling options. The generated image can be customized with font, color, alignment, and other visual properties.

ActionTry it

Create Live Stream

Tool to create a new live stream in Cloudinary. Use when you need to set up a new live streaming session. The created stream will provide connection details (URI and stream key) for pushing live content.

ActionTry it

Create Live Stream Output

Tool to create a new live stream output configuration. Use when you need to add an output destination to an existing live stream, such as simulcasting to YouTube, Facebook, or creating an archive.

ActionTry it

Create Metadata Field

Tool to create a new metadata field definition. Use when extending your metadata schema with new fields.

ActionTry it

Create Metadata Rule

Tool to create a new conditional metadata rule. Use when you need to automatically populate metadata fields based on conditions. The rule applies a value to a target metadata field when a condition on another metadata field is met.

ActionTry it

Create Multi-Resource Animation

Tool to create an animated image, video, or PDF from a set of images. Use when you need to combine multiple images into an animated format. Provide either a tag (to combine all images with that tag) or a list of URLs.

ActionTry it

Create Slideshow

Tool to create an auto-generated video slideshow from existing Cloudinary assets. Use when you need to compile multiple images or videos into a single video with transitions. The slideshow is created asynchronously; check status field or use notification_url for completion updates.

ActionTry it

Create Streaming Profile

Tool to create a new adaptive streaming profile in your Cloudinary account. Use when you need to define custom video quality settings for adaptive bitrate streaming. The profile will contain multiple representations at different resolutions and bitrates.

ActionTry it

Create Transformation

Tool to create a new named transformation by assigning a custom name to a set of transformation parameters. Use when you need to save and reuse a transformation configuration with a memorable name.

ActionTry it

Create Trigger

Tool to create a new webhook trigger for a specified event type. Use after configuring your webhook endpoint and choosing the event type. Example: "Create a trigger for uploads to https://example.com/hooks/cloudinary"

ActionTry it

Create Upload Mapping

Tool to create a new upload mapping folder and URL template. Use when you need to dynamically map external URL prefixes to a Cloudinary asset folder before uploading files.

ActionTry it

Create Upload Preset

Tool to create a new upload preset. Use when defining centralized upload options (tags, formats, transformations, etc.) before asset uploads.

ActionTry it

Delete Asset Relations by Asset ID

Tool to delete asset relations by asset ID. Use when you need to unrelate a specific asset from other assets.

ActionTry it

Delete Asset Relations by Public ID

Tool to delete asset relations by public ID. Use when you need to unrelate assets from a specific asset.

ActionTry it

Delete Derived Resources

Tool to delete derived assets. Use when you need to remove specific derived assets by their IDs. Example: "Delete derived assets with IDs [id1, id2]".

ActionTry it

Delete Folder

Tool to delete an empty asset folder. Use when the folder is confirmed empty and you need to remove it.

ActionTry it

Delete Live Stream

Tool to delete a live stream from Cloudinary. Use when you need to permanently remove a live stream that is no longer needed.

ActionTry it

Delete Live Stream Output

Tool to delete a live stream output from Cloudinary. Use when you need to remove a specific output configuration from a live stream.

ActionTry it

Delete Metadata Field

Tool to delete a metadata field by external ID. Use when you need to remove a metadata field that is no longer required.

ActionTry it

Delete Metadata Field Datasource Entries

Tool to delete datasource entries for a specified metadata field. Use when you need to soft-delete (inactivate) specific entries in a field's datasource. Example prompt: "Delete entries ['color1','color2'] from metadata field 'color_id'"

ActionTry it

Delete Metadata Rule

Tool to delete a conditional metadata rule by its ID. Use when you need to remove a metadata rule that is no longer required.

ActionTry it

Delete Resources by Asset ID

Tool to delete resources by asset IDs. Use when you need to permanently remove specific resources by their immutable asset IDs; irreversible.

ActionTry it

Delete Resources by Public ID

Tool to delete Cloudinary resources by public ID, prefix, or all resources. Use when you need to permanently remove specific assets by their public IDs, or bulk delete by prefix pattern. Deletion is irreversible.

ActionTry it

Delete Resources by Tags

Tool to delete Cloudinary assets by tag. Use when you need to remove all assets associated with a given tag.

ActionTry it

Delete Streaming Profile

Tool to delete a custom streaming profile or revert a built-in profile to original settings. Use when you need to remove a custom profile that is no longer needed.

ActionTry it

Delete Transformation (v2)

Tool to delete a named transformation from your Cloudinary account. Use when you need to remove a transformation that is no longer required.

ActionTry it

Delete Trigger

Tool to delete a trigger (webhook notification). Use when you need to remove a trigger by its ID after confirming the correct ID.

ActionTry it

Delete Upload Mapping

Tool to delete a folder upload mapping. Use when you need to remove an existing upload mapping configuration.

ActionTry it

Delete Upload Preset

Tool to delete an upload preset from the account. Use when you need to remove an upload preset that is no longer needed.

ActionTry it

Destroy Asset

Tool to permanently destroy a Cloudinary asset/resource by public ID. Use when you need to permanently delete a specific asset. This operation is irreversible and removes the asset from Cloudinary storage.

ActionTry it

Destroy Asset by ID

Tool to delete an asset by its immutable asset ID. Use when you need to permanently remove a specific asset using its asset ID; operation is irreversible.

ActionTry it

Explicit Resource Update

Tool to update an existing asset and/or eagerly generate derived transformations using Cloudinary's Explicit API. Use when you need to pre-generate transformations, update metadata, move assets to new folders, or modify tags on already-uploaded resources.

ActionTry it

Explode Multi-Page Resource

Tool to create derived images from multi-page files (PDF, PSD, TIFF, animated GIF) by exploding them into separate images. Use when you need to extract individual pages or frames from a multi-page resource. The operation is asynchronous and returns a batch_id for tracking.

ActionTry it

Generate Archive

Tool to create an archive (ZIP or TGZ file) containing a set of assets from your Cloudinary environment. Use when you need to download multiple assets as a single archive file. Supports filtering by tags, public IDs, or prefixes. The archive is created asynchronously if async=true; use notification_url to receive completion notifications.

ActionTry it

Generate Sprite

Tool to generate sprites by merging multiple images into a single large image. Use when you need to combine multiple images for efficient web delivery. Note: This API was deprecated in 2025 and may not be available in all Cloudinary accounts.

ActionTry it

Get Adaptive Streaming Profiles

Tool to list adaptive streaming profiles. Use when retrieving built-in and custom adaptive streaming profiles for delivering video via HLS or DASH.

ActionTry it

Get Analysis Task Status

Tool to get the status of an analysis task. Use when you need to check the progress or completion status of a previously submitted analysis task.

ActionTry it

Get Live Stream

Tool to get details of a single live stream by ID. Use when you need to retrieve configuration, status, and metadata of an existing live stream.

ActionTry it

Get Live Stream Output

Tool to get details of a single live stream output. Use when you need information about a specific output configuration for a live stream.

ActionTry it

Get Live Stream Outputs

Tool to get a list of live stream outputs. Use when you need to retrieve all outputs configured for a specific live stream in Cloudinary.

ActionTry it

Get Live Streams

Tool to get a list of live streams from Cloudinary. Use when you need to retrieve all configured live streams for your account.

ActionTry it

Get Metadata Field By ID

Tool to get a single metadata field definition by external ID. Use after creating or updating a metadata field to fetch its full definition. Example: "Get metadata field definition for external ID 'color_id'."

ActionTry it

Get product environment config details

Tool to get product environment config details. Use when you need to fetch or verify environment configuration such as folder_mode. Config values like folder_mode constrain uploads, folder creation, and preset creation — check this config before those operations to avoid mode conflicts.

ActionTry it

Get Resource by Asset ID

Get Resource by Asset ID

ActionTry it

Get Resource by Public ID

Tool to get details of a single resource by public ID. All three of resource_type, type, and public_id must exactly match the stored asset's values; a mismatch in any one causes lookup failure even if the asset exists under a different combination. Returns full asset, derived, and related info.

ActionTry it

Get Resource Tags

Tool to list all tags used for a specified resource type. Use when you need to retrieve or page through the tags assigned to your assets.

ActionTry it

Get Resources by Asset Folder

Tool to list assets stored directly in a specified folder. Use when you need to view assets in a specific folder without including subfolder contents.

ActionTry it

Get Resources by Context

Tool to retrieve assets with a specified contextual metadata key/value. Use when filtering resources by context metadata. Empty `resources` array indicates no matches, not an error. Enable `context`, `metadata`, `tags`, or `moderations` only when needed; use `fields` to limit payload size.

ActionTry it

Get Resources in Moderation

Tool to retrieve assets in a moderation queue by status. Use after moderation to process pending or reviewed assets.

ActionTry it

Get Root Folders

Tool to list all root folders in the product environment. Use when you need to retrieve top-level asset folders.

ActionTry it

Get Streaming Profile Details

Tool to get details of a single streaming profile by name. Use when you need to inspect an existing profile's configuration before making changes. Example: "Get details of streaming profile 'hd'."

ActionTry it

Get Transformation

Tool to retrieve details of a specific transformation. Use when you need to get information about a named transformation or transformation string, including its parameters, derived resources, and usage status.

ActionTry it

Get Transformations

Tool to list all transformations (named and unnamed). Use when you need to retrieve transformation definitions or paginate through transformation records.

ActionTry it

Get Upload Mapping Details

Tool to retrieve details of a single upload mapping by folder. Use when you need the URL prefix template associated with a specific mapping folder.

ActionTry it

Get Upload Mappings

Tool to list all upload mappings. Use when you need to retrieve and paginate through upload mapping configurations. For details of a specific mapping, use CLOUDINARY_GET_UPLOAD_MAPPING_DETAILS.

ActionTry it

Get Upload Preset

Tool to retrieve details of a single upload preset by name. Use when you need to inspect an existing preset's configuration.

ActionTry it

Get Usage

Tool to get product environment usage details. Use when you need to monitor your Cloudinary account storage, bandwidth, requests, and other usage limits. Exceeding these limits can silently block uploads and other operations; check usage when operations fail unexpectedly to rule out cap exhaustion.

ActionTry it

Get Video Views

Tool to get video analytics views from Cloudinary. Use when you need to retrieve video viewing statistics including watch time, viewer location, and device information.

ActionTry it

Idle Live Stream

Tool to manually idle a Cloudinary live stream. Use when you need to put an active live stream into idle state without stopping it completely.

ActionTry it

List Images

Tool to list image assets from Cloudinary. Use when you need to retrieve a list of image resources, with optional filtering by prefix, tags, or public IDs. Supports pagination for large result sets.

ActionTry it

List Metadata Fields

Tool to list all structured metadata fields defined in your Cloudinary product environment. Use to retrieve metadata schema definitions, optionally filtered by external IDs.

ActionTry it

List Metadata Rules

Tool to retrieve all conditional metadata rules defined in your Cloudinary account. Use when you need to list or audit metadata rules that automatically apply values to assets based on conditions.

ActionTry it

List Raw Files

Tool to list raw assets from Cloudinary. Use when you need to retrieve raw files with optional filtering by prefix, tags, or public IDs.

ActionTry it

List Resource Types

Tool to list all available resource types in your Cloudinary product environment. Use when you need to discover which resource types are available.

ActionTry it

List Resources by Asset IDs

Tool to retrieve multiple resources by their asset IDs. Use when you need to fetch details for multiple specific assets (up to 100) by their immutable asset IDs.

ActionTry it

List Resources by External IDs

Tool to retrieve resources by their external IDs. Use when you need to fetch multiple resources using external identifiers assigned during upload.

ActionTry it

List Resources by Tag

Tool to list resources (assets) with a specified tag. Use when you need to retrieve assets filtered by tag value.

ActionTry it

List Resources by Type

Tool to retrieve resources (assets) by resource type and storage type. Use when you need to list all assets of a specific type (image, video, raw) and storage method (upload, private, etc.).

ActionTry it

List Upload Presets

Tool to list all upload presets configured in the account. Use when you need to retrieve and paginate through upload preset configurations. For creating a new upload preset, use CLOUDINARY_CREATE_UPLOAD_PRESET.

ActionTry it

List Video Assets

Tool to list video assets from Cloudinary. Use when you need to retrieve video assets with optional filtering by prefix, public IDs, tags, or timestamps.

ActionTry it

List Webhook Triggers

Tool to list all webhook triggers for event types in your environment. Use when you need to retrieve or filter existing triggers by type.

ActionTry it

Manage Context Metadata

Tool to add or remove contextual metadata on Cloudinary assets. Use when you need to manage custom context key-value pairs on existing assets.

ActionTry it

Order Metadata Field Datasource

Tool to update ordering of a metadata field datasource. Use when you need to reorder enum or set values for a metadata field datasource before updating assets.

ActionTry it

Ping Cloudinary Servers

Tool to ping Cloudinary servers. Use when testing API reachability and authentication.

ActionTry it

Publish Resources

Tool to publish Cloudinary assets by public IDs, prefix, or tag. Use when you need to make authenticated or private assets publicly accessible.

ActionTry it

Rename or Move Resource Public ID

Tool to rename an asset's public ID using Cloudinary's rename endpoint. Use when reorganizing resources by changing public_id without re-uploading. Note: renaming changes URLs; optionally invalidate CDN caches.

ActionTry it

Reorder Metadata Field

Tool to change the position of a specific metadata field. Use when you need to reorder a single metadata field to a specific position in the list.

ActionTry it

Reorder Metadata Fields

Tool to reorder all metadata fields in the product environment. Use when you need to change the display order of metadata fields based on label, creation date, or external ID.

ActionTry it

Restore Deleted Resources

Tool to restore deleted Cloudinary resources by public IDs. Use when you need to recover previously deleted assets that have backups available. Only works if backups were enabled when the resources were deleted.

ActionTry it

Restore Metadata Field Datasource Entries

Tool to restore previously deleted datasource entries for a metadata field. Use after deleting entries to reactivate soft-deleted datasource entries.

ActionTry it

Restore Resources by Asset IDs

Tool to restore backed up assets by asset IDs. Use when you need to restore previously backed up resources from their immutable asset IDs. The API processes each asset ID independently; some may succeed while others fail.

ActionTry it

Search All Metadata Field Datasources

Tool to search across all metadata field datasources. Use when you need to find values across multiple metadata fields without knowing the specific field ID.

ActionTry it

Search Assets

Tool to search and filter assets using powerful query expressions. Use when you need to find specific assets by resource type, tags, metadata, or other attributes with sorting and pagination support.

ActionTry it

Search Datasource in Metadata Field

Tool to search datasource values in a metadata field. Use when looking for specific values in enum or set metadata fields.

ActionTry it

Search Folders

Tool to search asset folders with filtering, sorting, and pagination. Use when you need to locate specific folders by name, path, or creation date.

ActionTry it

Show Folder

Tool to list sub-folders within a specified folder. Use when you need to explore folder hierarchy or list nested folders.

ActionTry it

Update Asset Metadata

Tool to populate or update metadata field values on one or more Cloudinary assets. Use when you need to set structured metadata on existing assets using their public IDs.

ActionTry it

Update Folder

Tool to rename or move an existing asset folder. Use when you need to change the folder's name or location.

ActionTry it

Update Live Stream

Tool to update a live stream's configuration in Cloudinary. Use when you need to modify the name, idle timeout, or maximum runtime of an existing live stream.

ActionTry it

Update Live Stream Output

Tool to modify an existing live stream output configuration. Use when you need to update the name, URI, stream key, or other settings of a live stream output. Note: Default HLS and archive outputs cannot be updated; only custom simulcast outputs can be modified.

ActionTry it

Update Metadata Field

Tool to update a metadata field definition by external ID. Use when modifying an existing schema field (e.g., changing label or validation) without redefining all properties.

ActionTry it

Update Metadata Field Datasource

Tool to update the datasource (allowed values) for a metadata field. Use when replacing or modifying the predefined list of values for enum or set type metadata fields.

ActionTry it

Update Metadata Rule

Tool to update an existing conditional metadata rule. Use when you need to modify the name, condition, result, state, or position of a metadata rule.

ActionTry it

Update Resource by Asset ID

Tool to update asset properties by asset ID in Cloudinary. Use when you need to modify tags, metadata, display name, or other asset properties using the immutable asset ID.

ActionTry it

Update Resource by Public ID

Tool to update asset properties by public ID in Cloudinary. Use when you need to modify tags, metadata, display name, or other asset properties without re-uploading.

ActionTry it

Update Resource Tags

Tool to add, remove, replace, or remove all tags for one or more Cloudinary assets. Use when you need to manage tags on existing assets without re-uploading them. Constraint: Maximum 1000 total operations (public_ids * tags <= 1000).

ActionTry it

Update Streaming Profile

Tool to modify an existing adaptive streaming profile's configuration. Use when you need to update video quality settings for an existing profile. The updated profile will contain the new representations and display name specified in the request.

ActionTry it

Update Transformation (v2)

Tool to update the definition of an existing named transformation. Use when you need to modify transformation parameters or strict mode settings for a transformation.

ActionTry it

Update Trigger

Tool to update the callback URL of an existing webhook trigger. Use when you need to change the notification endpoint for a trigger by its ID.

ActionTry it

Update Upload Mapping

Tool to update an existing upload mapping by changing its remote URL template. Use when you need to modify the URL prefix for an existing folder mapping.

ActionTry it

Update Upload Preset

Tool to update an existing upload preset's configuration settings. Use when modifying preset options like tags, transformations, or analysis features.

ActionTry it

Upload Asset

Tool to upload media assets (images, videos, raw files) to Cloudinary. Use when you need to upload files from local storage or remote URLs. Supports both synchronous and asynchronous uploads with various transformation and analysis options.

ActionTry it

Upload File (Auto Detect)

Tool to upload files with automatic resource type detection. Use when uploading images, videos, or raw files without specifying the type. Cloudinary automatically detects whether the file is an image, video, or raw file based on its content.

ActionTry it

Upload File Chunk

Tool to upload a single chunk of a large file to Cloudinary. Use when implementing chunked upload for large files. All chunks of the same file must use the same x_unique_upload_id. The final chunk triggers processing and returns the complete upload response.

ActionTry it

Visual Search Assets

Tool to find images in your asset library based on visual similarity or content. Use when searching for visually similar images using an image URL, an existing asset, or a text description.

ActionTry it
Cloudinary integration | Dench