Cloudinary icon

Cloudinary

Upload images and videos, build optimized transformation and delivery URLs, generate video players, and manage, search, tag, and edit metadata in your Cloudinary media library

Actions23

Asset → Update Asset Tags

AI-generated

Overview

This node operation updates tags on assets in Cloudinary's media library. It supports two modes: 'Set' to replace all existing tags on an asset with new ones, and 'Append' to add new tags to the existing list without removing current tags. This is useful for managing and organizing media assets by tagging them appropriately, such as categorizing images or videos for easier search and retrieval.

Use Case Examples

  1. Replacing all tags on an image asset with a new set of tags.
  2. Appending additional tags to multiple video assets identified by their public IDs.

Properties

Name Meaning
Asset ID The immutable asset_id of the asset to update tags for. Required when using 'Set' mode.
Mode Determines how to apply the provided tags: 'Set' replaces all existing tags, 'Append' adds to existing tags.
Public ID(s) The public ID(s) of the asset(s) to tag, used only in 'Append' mode. Can be a single ID or multiple comma-separated IDs.
Resource Type The type of asset to tag (image, video, or raw), used in 'Append' mode.
Type The 'type' property of the asset (upload, private, authenticated, fetch), used in 'Append' mode to scope the public IDs correctly.
Tags A comma-separated list of tag names to assign to the asset(s). Required.
Update Fields Additional options for updating tags, such as whether to invalidate CDN cache copies of the asset.

Output

JSON

  • json - The updated asset metadata including the new tags.

Dependencies

  • Cloudinary API credentials including cloud name, API key, and API secret.

Troubleshooting

  • Ensure the correct mode ('set' or 'append') is selected to avoid unexpected tag updates.
  • When using 'append' mode, public IDs must be valid and correspond to the specified resource type and asset type.
  • If CDN cache invalidation is enabled, allow some time for changes to propagate.
  • Common errors include unsupported operations or missing required parameters like asset ID or tags.

Links

Discussion