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 Structured Metadata

AI-generated

Overview

This node operation updates the structured metadata of an existing asset in Cloudinary by its public ID. It is useful for scenarios where you need to modify or add detailed metadata information to an image, video, or raw asset stored in Cloudinary, such as updating tags, descriptions, or custom fields in JSON format.

Use Case Examples

  1. Updating the metadata of an image asset to include new descriptive fields for better searchability.
  2. Modifying the structured metadata of a video asset to add custom attributes used in a media management workflow.

Properties

Name Meaning
Public ID The public ID of the asset to update, used to identify the specific asset in Cloudinary.
Resource Type The type of asset to update, such as image, video, or raw file.
Type The storage type of the asset, defining its accessibility and storage method.
Structured Metadata The JSON object containing the structured metadata fields and values to attach to the asset.
Invalidate CDN Whether to invalidate CDN cache copies of the asset to ensure updated metadata is served.

Output

JSON

  • publicId - The public ID of the updated asset.
  • resourceType - The type of the asset updated (image, video, raw).
  • type - The storage type of the asset.
  • structuredMetadata - The updated structured metadata JSON object attached to the asset.
  • invalidate - Indicates if CDN cache invalidation was requested.

Dependencies

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

Troubleshooting

  • Ensure the public ID provided matches an existing asset in your Cloudinary account; otherwise, the update will fail.
  • Verify that the structured metadata JSON is correctly formatted to avoid JSON parsing errors.
  • If CDN cache invalidation is enabled, allow some time for the cache to clear before seeing updated metadata.
  • Check that the Cloudinary API credentials are valid and have sufficient permissions to update asset metadata.

Links

Discussion