Updates an existing asset's metadata, tags, and other attributes using its asset ID
Updates one or more attributes of a specified resource (asset) by its asset ID. This enables you to update details of an asset by its unique and immutable identifier, regardless of public ID, display name, asset folder, resource type or delivery type. Note that you can also update attributes of an existing asset using the explicit API endpoint.
Basic authentication using Cloudinary API Key and API Secret.
In: header
Path Parameters
The cloud name of your product environment.
The asset ID of the resource. Must be a 32-character hexadecimal string.
^[0-9a-f]{32}$Request Body
application/json
The asset attributes to update.
The resource properties to update.
The display name of the resource.
Whether to ensure the display name is unique across all resources. If false, the operation will fail if a resource with the same display name exists. Default: false
falseThe folder where the asset should be placed.
A comma-separated list of tag names, or an array of tag names.
A pipe-separated list of key-value pairs of general textual context metadata to attach to the asset (e.g., "alt=My image|caption=Nice photo"). A literal = or | inside a value must be escaped with a prepending backslash, and a literal backslash must be doubled. A double quote must not be escaped.
A pipe-separated list or a map of custom metadata fields (by external_id) and the values to assign to each of them. The = " and | characters can be supported as values when escaped with a prepended backslash (). For a multi-select field, you can set a maximum of 3000 different metadata values on an asset.
Whether to clear invalid metadata fields. If false, invalid fields will be preserved. Default: false
falseFace coordinates as comma-separated values, with multiple faces separated by pipes.
^(\d+,\d+,\d+,\d+)(\|\d+,\d+,\d+,\d+)*$Custom coordinates as comma-separated values, with multiple coordinates separated by pipes.
^(\d+,\d+,\d+,\d+)(\|\d+,\d+,\d+,\d+)*$A JSON-encoded object of named groups of coordinate pairs representing regions. Each region name may contain only letters, numbers, or hyphens, and must have at least two coordinate pairs.
Quality override value that will override any automatic quality transformations.
The moderation status of the resource.
Value in
- "approved"
- "rejected"
Confidence threshold for auto-tagging.
0 <= value <= 1The type of detection to perform on the resource.
The type of OCR to perform on the resource. Set to adv_ocr, optionally with options (e.g., adv_ocr:document).
The conversion to apply for raw files (e.g., aspose, google_speech, extract_text).
The type of categorization to perform on the resource. Optionally append a language code suffix (e.g., google_tagging:fr).
Whether to index the resource with visual search. If true, the resource will be indexed for visual search capabilities. Default: false
The background removal provider to use for the resource. Optionally append a template suffix (e.g., cloudinary_ai:fine_edges).
Restricts access to the asset by specifying one or more access types. The asset is restricted unless at least one listed access type is valid.
Response Body
application/json
application/json
application/json
application/json
curl -X PUT "https://example.com/v1_1/my_cloud/resources/f4e6579cf84dd9cf5683b21f5b30c7d9" \ -H "Content-Type: application/json" \ -d '{}'{ "asset_id": "bc71d3cedb739ed931be3706e94c413a", "public_id": "qdi8r768kj5tticu8keh", "format": "jpg", "version": 1747134921, "resource_type": "image", "type": "upload", "created_at": "2025-05-13T11:15:21Z", "bytes": 206960, "width": 400, "height": 300, "asset_folder": "", "display_name": "qdi8r768kj5tticu8keh", "url": "http://res.cloudinary.com/cloud-name/image/upload/v1747134921/qdi8r768kj5tticu8keh.jpg", "secure_url": "https://res.cloudinary.com/cloud-name/image/upload/v1747134921/qdi8r768kj5tticu8keh.jpg", "moderation_kind": "manual", "moderation_status": "approved", "moderation": [ { "kind": "manual", "status": "approved", "updated_at": "2025-05-13T11:15:22Z" } ]}Get resource by asset ID GET
Returns the details of a single resource specified by its asset ID.
Retrieves a list of tags currently applied to assets in your Cloudinary account GET
Retrieves a comprehensive list of all tags that exist in your product environment for assets of the specified type. [Cloudinary Admin API documentation](https://cloudinary.com/documentation/admin_api)