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 (Legacy, by Public ID) → Update Asset Tags

AI-generated

Overview

This node operation updates tags on assets in Cloudinary by their public ID. It supports replacing all existing tags with a new set or appending new tags to the existing list. Users specify the asset's public ID, resource type (image, video, raw), storage type, and the mode of tag update (set or append). This is useful for managing and organizing media assets in Cloudinary by updating their tags programmatically.

Use Case Examples

  1. Replacing all tags on an image asset with a new set of tags.
  2. Appending additional tags to a video asset without removing existing tags.

Properties

Name Meaning
Public ID The public ID of the asset to update, used to identify the specific asset.
Resource Type The type of asset to update, such as image, video, or raw.
Type The storage type of the asset, indicating how the asset is stored in Cloudinary.
Mode How to apply the provided tags: either replace all existing tags (set) or add to existing tags (append).
Type (for append mode) The storage type of the asset when appending tags, must match the asset's type for correct lookup.
Public ID(s) (for append mode) One or more public IDs of assets to tag, can be a single ID or multiple IDs separated by commas.
Tags A comma-separated list of tag names to assign to the asset(s).
Update Fields Additional options for updating the asset, such as whether to invalidate CDN cache copies of the asset.

Output

JSON

  • json - The updated asset data or error information if the update fails.

Dependencies

  • Cloudinary API credentials (cloud name, API key, API secret)

Troubleshooting

  • Ensure the public ID matches an existing asset; otherwise, the update will fail.
  • Verify that the resource type and storage type match the asset's actual type in Cloudinary.
  • If appending tags, ensure the tagAppendType matches the asset's storage type to avoid lookup issues.
  • Check API credentials and permissions if authentication errors occur.
  • If CDN cache is not invalidated as expected, verify the 'Invalidate CDN' option is set correctly.

Links

Discussion