@cloudinary/asset-management-mcpv0.9.3

The type of resource (image, video, raw, or auto).

The file to upload and associated parameters.

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.

Deprecated. Use access_control instead. Allows the asset to behave as if it's of the authenticated delivery type while still using the default 'upload' type in delivery URLs. The asset can later be made public by changing its access_mode via the Admin API, without having to update any delivery URLs.

Whether to return accessibility analysis values for the image.

A comma-separated list of file formats that are allowed for uploading. Files of other types will be rejected. The formats can be any combination of image types, video formats or raw file extensions.
Note: You can also add the format parameter to convert other file types instead of rejecting them. In this case, only files that would normally be rejected are converted, any file format allowed for upload won't be converted.

The asset folder to assign to the asset.

When set to true, returns the uploaded asset's public_id immediately in the response, before the upload is completed (asynchronously). Default: false.

Whether to trigger automatic generation of video chapters. Chapters will be generated and saved as a .vtt file with -chapters appended to the public ID of the video. You can enable chapters as part of the Cloudinary Video Player. Relevant for videos only.

Automatically assigns tags to an asset according to detected objects or categories with a confidence score higher than the specified value.
Use together with the detection parameter for:
Use together with the categorization parameter for:

• Cloudinary AI Content Analysis
• Amazon Rekognition Celebrity Detection
• Google Automatic Video Tagging
• Google Auto Tagging
• Imagga Auto Tagging
• Amazon Rekognition Auto Tagging

Automatically remove the background of an image using an add-on.
Optionally append a template suffix (e.g., cloudinary_ai:fine_edges).
Relevant for images only.

• Set to cloudinary_ai to use the deep-learning based Cloudinary AI Background Removal add-on.
• Note: this feature has been superseded by background removal on the fly.
• Set to pixelz to use the human-powered Pixelz Remove-The-Background Editing add-on service.

Whether to backup the uploaded asset. When set to true, backs up uploaded assets to a secondary storage bucket.

A URL to redirect to after the upload/explicit is completed instead of returning the upload response.
Signed upload result parameters are added to the callback URL. This parameter is ignored for XHR (Ajax XMLHttpRequest) or JavaScript Fetch API upload requests.
Note: This parameter is relevant for direct uploads from a form in the browser. It is automatically set if you perform direct upload from the browser using Cloudinary's SDKs and the jQuery plugin.

A comma-separated list of the categorization add-ons to run on the asset.
Set to google_tagging, google_video_tagging, imagga_tagging and/or aws_rek_tagging
to automatically classify the scenes of the uploaded asset.
Optionally append a language code suffix (e.g., google_tagging:fr).

Whether to return a cinemagraph analysis value for the media asset between 0 and 1, where 0 means the asset is not a cinemagraph and 1 means the asset is a cinemagraph. Relevant for animated images and video only. A static image will return 0.

Whether to clear metadata field values that have become invalid due to a change in metadata rules. If false, the API returns an error if any existing metadata value is no longer valid. Default: false.

Whether to retrieve predominant colors & color histogram of the uploaded image. Note: If all returned colors are opaque, then 6-digit RGB hex values are returned. If one or more colors contain an alpha channel, then 8-digit RGBA hex quadruplet values are returned.

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"). The =, ", and | characters can be escaped with a prepending backslash (\).

Custom coordinates as comma-separated values, with multiple coordinates separated by pipes.

Invokes the relevant add-on to return a list of detected content.
Set to:

• <content-aware model>_[<version>] (e.g. coco_v2) to return a list of detected content using the Cloudinary AI Content Analysis add-on. Can be used together with the auto_tagging parameter to apply tags automatically.
• captioning to analyze an image and suggest a caption based on the image's contents.
• iqa to analyze the quality of an image.
• watermark-detection to detect watermarks in an image.
• adv_face to return a list of facial attributes using the Advanced Facial Attribute Detection add-on.
• aws_rek_face to return a list of detected celebrities and facial attributes using the Amazon Rekognition Celebrity Detection add-on. Can be used together with the auto_tagging parameter to apply tags automatically.

Whether to discard the name of the original uploaded file. Relevant when delivering assets as attachments (setting the flag disposition:attachment in delivery URLs).

A display name for the asset.

A list of transformations to eagerly generate for the asset. Accepts either a single transformation or a pipe-separated list of transformations.

Whether to generate the eager transformations asynchronously in the background after the upload request is completed rather than before the upload is completed.

A URL to notify when eager transformations are completed.

Allows you to modify upload parameters by specifying custom logic with JavaScript. This can be useful for conditionally adding tags, contextual metadata, structured metadata or eager transformations depending on specific criteria of the uploaded file.

Face coordinates as comma-separated values, with multiple faces separated by pipes.

Whether to detect faces in the asset.

One of the following:

• The remote HTTP or HTTPS URL address of an existing file.
• The Data URI (Base64 encoded), max ~60 MB (62,910,000 chars).
• The FTP address of an existing file.
• Local file path starting with file://.

Overrides the originally uploaded asset's file name in downloads that use flags like fl_attachment or fl_force_original.

Folder name where the uploaded asset will be stored. This parameter applies when using the Admin API, or when specifying the upload preset for unsigned uploading with the Upload API.

An optional format to convert the uploaded asset to before saving in the cloud.

An HTTP header or a list of headers lines for adding as response HTTP headers when delivering the asset to your users. Supported headers: Link, Authorization, X-Robots-Tag.

Whether to invalidate CDN cache copies of a previously uploaded asset that shares the same public ID. Default: false.

Whether to return IPTC, XMP, and detailed Exif metadata of the uploaded asset in the response.
Supported for images, video, and audio.

• Returned metadata for images includes: PixelsPerUnitX, PixelsPerUnitY, PixelUnits, Colorspace, and DPI.
• Returned metadata for audio and video includes: audio_codec, audio_bit_rate, audio_frequency, channels, channel_layout.
• Additional metadata for video includes: pix_format, codec, level, profile, video_bit_rate, dar.

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.

For all asset types, set to:

• manual to add the uploaded asset to a list of pending assets that can be moderated using the Admin API or the Cloudinary Console.
• perception_point to automatically moderate the uploaded asset using the Perception Point Malware Detection add-on.

For images only, set to:

• webpurify to automatically moderate the uploaded image using the WebPurify Image Moderation add-on.
• aws_rek to automatically moderate the uploaded image using the Amazon Rekognition AI Moderation add-on.
• duplicate:<threshold> to detect if the same or a similar image already exists using the Cloudinary Duplicate Image Detection add-on. Set threshold to a float greater than 0 and less than or equal to 1.0 to specify how similar an image needs to be in order to be considered a duplicate. Set threshold to 0 to add an image to the index of images that are searched when duplicate detection is invoked for another image.

For videos only, set to:

• aws_rek_video to automatically moderate the uploaded video using the Amazon Rekognition Video Moderation add-on.
• google_video_moderation automatically moderate the uploaded video using the Google AI Video Moderation add-on.

To request multiple moderations in a single API call:

• Send the desired list of moderations as a pipe-separated string with manual moderation, if relevant, being last.

Note: Rejected assets are automatically invalidated on the CDN within approximately ten minutes.

A URL to notify when the asset is ready.

Set to adv_ocr to extract all text elements in an image as well as the bounding box
coordinates of each detected element using the OCR text detection and extraction add-on.
Optionally append options (e.g., adv_ocr:document).

Allows you to update an asset by specifying custom logic with JavaScript that is executed after the upload to Cloudinary is completed successfully. This can be useful for conditionally adding tags, contextual metadata, and structured metadata, depending on the results of using the detection parameter on upload.

Whether to overwrite existing assets with the same public ID. When set to false, return immediately if an asset with the same public ID already exists. Default: true (when using unsigned upload, the default is false and cannot be changed to true).

Whether to return the perceptual hash (pHash) on the uploaded image for image similarity detection.

A proxy to use for fetching remote URLs. The format should be http://hostname:port.

The identifier that is used for accessing the uploaded asset. If not specified, a unique ID is generated automatically.

A string or path that's automatically prepended to the public_id with a forward slash. The value can contain the same characters as the public_id including additional forward slashes. This prefix can be useful to provide context and improve the SEO of an asset's filename in the delivery URL, but the value does not impact the location where the asset is stored.

Whether to return a quality analysis value for the image between 0 and 1, where 0 means the image is blurry and out of focus and 1 means the image is sharp and in focus. Relevant for images only.

Generates a related file based on the uploaded file.

• Set to aspose to automatically create a PDF or other image format from a raw Office document using the Aspose Document Conversion add-on. (Asynchronous)
• Set to google_speech to instruct the Google AI Video Transcription add-on to generate an automatic transcript raw file from an uploaded video. (Asynchronous)
• Set to extract_text to extract all the text from a PDF file and store it in a raw JSON file with a public ID in the format: [pdf_public_id].extract_text.json. The full URL of the generated JSON file is included in the API response. Unlike the above raw_convert options, this option doesn't require registering for an add-on.(Synchronous)
• Set to azure_video_indexer to generate AI-powered video insights from Microsoft Azure. (Asynchronous)

Named region coordinate groups for cropping with region gravity.
Can be a JSON-encoded string or an object. Each region name may contain
only letters, numbers, or hyphens, and must have at least two coordinate pairs.

Settings to automatically generate breakpoints for responsive images.

Whether to return a deletion token in the upload response. The token can be used to delete the uploaded asset within approximately 10 minutes using an unauthenticated API call.

A comma-separated list of tag names, or an array of tag names.

An incoming transformation to run on the uploaded asset before its storage. In contrast to eager, this parameter is applied before the file is stored.

The delivery type that defines if and how the uploaded asset is available for public delivery. By default, all uploaded assets are public (upload).

Whether the display name should be unique.

When set to false and used together with use_filename, if an asset with the same file name already exists, no random characters are appended to the file name. Instead, the asset is overwritten. Default: true (random characters are added to the file name if needed).

(Required for unsigned uploading / optional for signed uploading)
Name of an upload preset that you defined for your Cloudinary product environment. An upload preset consists of upload parameters centrally managed using the Admin API or from the Upload Presets page of the Console Settings. An upload preset may be marked as unsigned, which allows unsigned uploading directly from the browser and restricts the optional parameters to: public_id, folder, tags, context, face_coordinates, regions and custom_coordinates.

Whether to add the asset_folder value as a prefix to the public_id value (prepended with a forward slash). This ensures that the public ID path will always match the initial asset folder, and can help to retain the behavior that previously existed in fixed folder mode. However, keep in mind that even when this option is used during upload, an asset with a certain public ID path can later be moved to a completely different asset folder hierarchy without impacting the public ID. This option only ensures path matching for the initial upload. Relevant only when public_id_prefix (or folder) has not been separately specified.

Whether to use the original file name of the uploaded asset if available for the public ID. The file name is normalized and random characters are appended to ensure uniqueness if the file name already exists. Default: false.

Whether to automatically assign the original filename of the uploaded asset as the asset's display name. Relevant only if the display_name parameter isn't set.

Whether to index the image for use with visual searches. Relevant for images only.

The type of resource (image, video, or raw).

The rename request parameters.

Whether to include contextual metadata in the response. Default is false.

The public ID of the asset to rename.

Whether to invalidate CDN cache copies of the renamed asset. Default is false.

Whether to include structured metadata in the response. Default is false.

URL to notify when the operation is complete.

Whether to overwrite the target asset if it already exists. Default is false.

The new public ID for the asset.

The target delivery type for the renamed asset. If omitted, the delivery type remains unchanged.

The current delivery type of the asset.

The type of resource for archive generation (image, video, or raw).

The archive generation parameters.

Whether to allow missing assets in the archive. If false, the operation will fail if any asset is not found.

A list of asset folder paths to include in the archive, or a single folder path string. Only available when asset folders are enabled for your account.

("create" mode only), specifies whether to generate the archive asynchronously.

("download" mode only) Unix timestamp indicating when the generated archive URL should expire.

Whether to flatten all files to be in the root of the archive file.

Whether to flatten the folder structure of the derived assets.

A list of fully qualified public IDs (resource_type/type/public_id) to include in the archive.

Whether to keep the derived assets used for generating the archive.

The method for generating and delivering the archive. Options:
download - Generates and delivers the archive file without storing it
create - Creates and stores the archive as a raw asset, returning URLs in the response
create_and_download - Creates, stores, and delivers the archive file

("create" mode only), specifies the URL to notify when the archive generation is complete.

Select all assets where the public ID starts with this prefix.

The list of public IDs to include in the archive.

A search expression to select assets to include in the archive.

Whether to skip adding the transformation details to the file names in the archive.

Tags to filter which assets to include in the archive. Assets matching any of the specified tags are included.

The folder in your product environment where the generated archive should be stored.

The filename for the downloaded archive file. Extension must match target_format (zip or tgz).

The format of the generated archive.

The public ID to assign to the generated archive, or the filename of the downloaded archive file.

A list of tag names to assign to the generated archive.

The transformations to apply to the assets before including them in the archive (separated by "|").

All supported delivery types.

Whether to use the original filenames of the assets in the archive instead of public IDs (when available).

The asset ID of the resource. Must be a 32-character hexadecimal string.

The version ID of the backup to download. Must be a 32-character hexadecimal string.

The asset to delete and related options.

A 32-character hexadecimal asset ID.

URL for redirect after operation completion.

Whether to invalidate CDN cache. Default is false.

URL to receive completion notification.

The delivery type to filter by. When omitted, returns assets of all delivery types.

A public_id prefix. When specified, all assets with that prefix are returned.

An array of public IDs to return.

Whether to include the list of tag names assigned to each asset. Default is false.

Cursor for pagination.

Maximum number of results to return (1-500).

The sort direction for the results. Default is "desc".

An ISO-8601 formatted timestamp. When specified, returns resources created since that timestamp. Supported only if neither prefix nor public_ids were passed.

Additional fields to include in the response. The fields public_id and asset_id are always included.

The delivery type to filter by. When omitted, returns assets of all delivery types.

A public_id prefix. When specified, all assets with that prefix are returned.

An array of public IDs to return.

Whether to include the list of tag names assigned to each asset. Default is false.

Cursor for pagination.

Maximum number of results to return (1-500).

The sort direction for the results. Default is "desc".

An ISO-8601 formatted timestamp. When specified, returns resources created since that timestamp. Supported only if neither prefix nor public_ids were passed.

Additional fields to include in the response. The fields public_id and asset_id are always included.

The delivery type to filter by. When omitted, returns assets of all delivery types.

A public_id prefix. When specified, all assets with that prefix are returned.

An array of public IDs to return.

Whether to include the list of tag names assigned to each asset. Default is false.

Cursor for pagination.

Maximum number of results to return (1-500).

The sort direction for the results. Default is "desc".

An ISO-8601 formatted timestamp. When specified, returns resources created since that timestamp. Supported only if neither prefix nor public_ids were passed.

Additional fields to include in the response. The fields public_id and asset_id are always included.

The asset ID of the resource. Must be a 32-character hexadecimal string.

Whether to include color information (predominant colors and histogram of 32 leading colors). Default: false.

Whether to include IPTC, XMP, and detailed Exif metadata in the response. Default: false.

Whether to include a list of coordinates of detected faces. Default: false.

Whether to return quality analysis scores for the image. Default: false.

Whether to return accessibility analysis scores for the image. Default: false.

Whether to report the number of pages in multi-page documents (e.g., PDF). Default: false.

Whether to include the perceptual hash (pHash) of the uploaded photo for image similarity detection. Default: false.

Whether to include previously specified custom cropping coordinates and faces coordinates. Default: false.

Whether to include details of all the backed up versions of the asset. Default: false.

Maximum number of derived assets to return. Default: 10.

The cursor for the next page of derived assets when there are more derived images than max_results.

The asset ID of the resource. Must be a 32-character hexadecimal string.

The asset attributes to update.

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.

The folder where the asset should be placed.

Confidence threshold for auto-tagging.

The background removal provider to use for the resource. Optionally append a template suffix (e.g., cloudinary_ai:fine_edges).

The type of categorization to perform on the resource. Optionally append a language code suffix (e.g., google_tagging:fr).

Whether to clear invalid metadata fields. If false, invalid fields will be preserved. Default: false

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"). The =, ", and | characters can be escaped with a prepending backslash (\).

Custom coordinates as comma-separated values, with multiple coordinates separated by pipes.

The type of detection to perform on the resource.

The display name of the resource.

Face coordinates as comma-separated values, with multiple faces separated by pipes.

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.

The moderation status of the resource.

The type of OCR to perform on the resource. Set to adv_ocr, optionally with options (e.g., adv_ocr:document).

Quality override value that will override any automatic quality transformations.

The conversion to apply for raw files (e.g., aspose, google_speech, extract_text).

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.

A comma-separated list of tag names, or an array of tag names.

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

Whether to index the resource with visual search. If true, the resource will be indexed for visual search capabilities. Default: false

The type of resource (image, video, or raw).

Limit the returned tags to those that start with the specified prefix.

Cursor for pagination.

Maximum number of results to return (1-500).

The derived resource IDs to delete.

Array of derived resource IDs to delete specific derived resources

Whether to invalidate the CDN cache for the deleted resources

The date for which to retrieve usage details (YYYY-MM-DD). If not specified, returns the current usage.

The asset ID of the resource. Must be a 32-character hexadecimal string.

The asset IDs to relate.

Relates the asset to all the assets specified in this array of up to 10 assets, specified by their asset IDs.

The asset ID of the resource. Must be a 32-character hexadecimal string.

The asset IDs to unrelate.

Unrelates the asset from all the assets specified in this array of assets, specified by their asset IDs.

The full path of the folder, including any nested folders. Must not be empty, and must not contain double slashes or leading/trailing slashes.

The new folder path.

The new path for the folder.

The full path of the folder, including any nested folders. Must not be empty, and must not contain double slashes or leading/trailing slashes.

The full path of the folder, including any nested folders. Must not be empty, and must not contain double slashes or leading/trailing slashes.

The (Lucene-like) string expression specifying the search query. If not passed, returns all folders (up to max_results).

Sort order for the results. Each item maps a field name to a direction.

Maximum number of folders to return (max 500, default 50).

The cursor for pagination. Use the next_cursor value from a previous response to get the next page of results.

The search query parameters.

Fields or ranges to aggregate search results by. Requires a Tier 2 search plan; on Tier 1 the field is accepted but aggregations are omitted from the response.

The Lucene-like search expression. Supports token match (:), exact match (=), trailing * for prefix match, ranges ([a TO b], {a TO b}), and comparisons (>, <, >=, <=). Combine terms with uppercase AND, OR, NOT, or +/-. NOT must appear between clauses — a leading NOT is a parse error; use -field:value to negate the first clause. Group with parentheses.

Wrap values containing spaces, colons, or other reserved characters (! ( ) { } [ ] ^ ~ ? \ = & < > |) in double quotes, e.g. tags:"service:mantels", aspect_ratio:"16:9". Send raw </>, never HTML-escaped.

Wildcards are prefix-only (trailing *). A bare * (e.g. folder:*, context.alt:*, metadata.key:*, tags:*, -tags:*) is a parse error — there is no "has any value" / presence probe. Either drop the clause, use a concrete prefix, or filter on a known token.

Dates: ISO-8601 in quotes, or relative shorthand 1h, 1d, 1w, 1m, 1y (uploaded_at>1d, created_at:[4w TO 1w]).

Supported fields: public_id, asset_id, filename, display_name, folder / asset_folder (singular, not folders), tags, context.<key>, metadata.<external_id>, resource_type, type, format, bytes, width, height, duration, pages, aspect_ratio, transparent, grayscale, status, moderation_status, moderation_kind, uploaded_at, created_at, taken_at, updated_at, last_updated.<kind>, face_count, illustration_score, quality_score. Fields under image_metadata.*, image_analysis.*, quality_analysis.*, and accessibility_analysis.* also require the matching with_field to be returned in the response.

See the [search expressions guide](https://cloudinary.com/documentation/search_expressions.md) for the full reference.

A comma-separated list of fields to include in the response.
Notes:

• This parameter takes precedence over the with_field parameter, so if you want any additional asset attributes returned, make sure to also include them in this list (e.g., tags or context).
• The following fields are always included in the response: public_id, asset_id, asset_folder, created_at, status, type, and resource_type.

The maximum number of results to return. Default - 50. Maximum - 500.
Set to 0 to get only total_count and aggregations without any resources in the response — useful for counting or aggregation-only queries.

The cursor value to get the next page of results. Available when a previous search returned more results than max_results.

An array of single-key objects mapping a field to a sort direction. Each object must contain exactly one field name mapped to 'asc' or 'desc'.
Default: [{"created_at": "desc"}].

The additional asset attributes to include in each search result. The fields parameter takes precedence over this parameter. image_metadata, image_analysis, and metadata require a Tier 2 search plan.

The visual search parameters.

The public ID of the existing asset to transform

VALIDATED transformation string using ONLY parameters from get-tx-reference docs. Examples: 'c_fill,w_300,h_200' or 'e_sepia/a_90'. MUST follow component rules: commas within components, slashes between components.

The resource type of the asset

Whether to invalidate cached versions