Cloudinary icon

Cloudinary

Upload to Cloudinary

Actions5

Overview

This node integrates with Cloudinary to update existing assets' structured metadata. Specifically, the "Update Asset Structured Metadata" operation allows users to attach or modify structured metadata on an asset identified by its public ID. This is useful for enriching media assets (images, videos, raw files) with custom metadata fields that can be used for categorization, search, or other organizational purposes.

Practical scenarios include:

  • Adding descriptive metadata to images for better searchability.
  • Updating video assets with new tags or metadata after content review.
  • Managing structured metadata in bulk workflows where asset details need to be programmatically updated.

Properties

Name Meaning
Public ID The unique identifier of the asset to update.
Resource Type The type of asset to update. Options: Image, Video, Raw.
Type The storage type of the asset. Options: Upload, Private, Authenticated, Fetch.
Structured Metadata JSON object containing key-value pairs representing the structured metadata to attach to the asset.
Update Fields Additional options for updating the asset. Currently supports: Invalidate CDN (boolean) to clear cache.

Output

The node outputs a JSON object representing the response from Cloudinary's API after updating the asset's structured metadata. This typically includes confirmation of the update and the current state of the asset's metadata.

No binary data output is produced by this operation.

Example output structure (simplified):

{
  "public_id": "sample_asset",
  "resource_type": "image",
  "type": "upload",
  "metadata": {
    "field1": "value1",
    "field2": "value2"
  },
  ...
}

Dependencies

  • Requires a valid Cloudinary account with API credentials (cloud name, API key, API secret).
  • The node uses these credentials to authenticate API requests.
  • No additional external dependencies beyond Cloudinary's REST API.

Troubleshooting

  • Invalid JSON for structured metadata: If the structured metadata input is not valid JSON, the node will throw an error. Ensure the JSON is correctly formatted.
  • Authentication errors: Incorrect or missing API credentials will cause authentication failures. Verify that the API key and secret are correct and have sufficient permissions.
  • Asset not found: If the provided Public ID does not correspond to an existing asset, the API will return an error. Confirm the Public ID is accurate.
  • CDN invalidation issues: If the "Invalidate CDN" option is enabled but changes do not reflect immediately, it may be due to CDN propagation delays.

Links and References

Discussion