cloudinary-assets - Pinkfish - AI Agents & Workflows for Getting Work Done

Server path: /cloudinary-assets | Type: Application | PCID required: Yes

Tools

Tool	Description
`cloudinary_assets_create_asset_relations_by_asset_id`	Add related assets by asset ID
`cloudinary_assets_create_asset_relations_by_public_id`	Create asset relations by public ID
`cloudinary_assets_delete_asset_relations_by_asset_id`	Delete asset relations by asset ID
`cloudinary_assets_delete_asset_relations_by_public_id`	Delete asset relations by public ID
`cloudinary_assets_delete_backup_versions`	Delete backed up versions
`cloudinary_assets_delete_resources_by_public_id`	Delete resources by public ID
`cloudinary_assets_derived_destroy`	Delete derived resources
`cloudinary_assets_destroy_asset`	Destroys an asset/resource
`cloudinary_assets_destroy_by_asset_id`	Delete asset by asset-id
`cloudinary_assets_download_asset`	Generates a download link for a specific asset (image)
`cloudinary_assets_download_backup_asset`	Download a backup copy of an asset
`cloudinary_assets_explicit_asset`	Apply operations on an existing asset
`cloudinary_assets_explode_resource`	Create derived images from multi-page file
`cloudinary_assets_generate_archive`	Creates an archive (ZIP or TGZ file) that contains a set of assets from your product environment.
`cloudinary_assets_get_resource_by_asset_id`	Get resource by asset ID
`cloudinary_assets_get_resource_by_public_id`	Get resource by public ID
`cloudinary_assets_get_video_views`	Get video views
`cloudinary_assets_list_images`	Get image assets
`cloudinary_assets_list_raw_files`	Get raw assets
`cloudinary_assets_list_resource_tags`	Retrieves a list of tags currently applied to assets in your Cloudinary account
`cloudinary_assets_list_resource_types`	Get resource types
`cloudinary_assets_list_resources_by_asset_folder`	Get resources by asset folder
`cloudinary_assets_list_resources_by_asset_ids`	Get resources by asset IDs
`cloudinary_assets_list_resources_by_context`	Get resources by context
`cloudinary_assets_list_resources_by_external_ids`	Get resources by external IDs
`cloudinary_assets_list_resources_by_moderation_kind_and_status`	Get resources by moderation kind and status
`cloudinary_assets_list_videos`	Get video assets
`cloudinary_assets_rename_asset`	Updates an existing asset’s identifier (public ID) and optionally other metadata in your Cloudinary account
`cloudinary_assets_restore_resources_by_asset_ids`	Restore assets by asset ID
`cloudinary_assets_text`	Create image from text
`cloudinary_assets_update_resource_by_asset_id`	Updates an existing asset’s metadata, tags, and other attributes using its asset ID
`cloudinary_assets_update_resource_by_public_id`	Update asset by public ID
`cloudinary_assets_upload`	Uploads media assets (images, videos, raw files) to your Cloudinary product environment
`cloudinary_assets_upload_chunk`	Upload a single chunk of a large file
`cloudinary_assets_upload_no_resource_type`	Upload with automatic file type detection

cloudinary_assets_create_asset_relations_by_asset_id

Add related assets by asset ID Parameters:

Parameter	Type	Required	Default	Description
`asset_id`	string	Yes	—	The asset ID of the resource. Must be a 32-character hexadecimal string.
`assets_to_relate`	string[]	Yes	—	Relates the asset to all the assets specified in this array of up to 10 assets, specified by their asset IDs.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_id": {
      "type": "string",
      "description": "The asset ID of the resource. Must be a 32-character hexadecimal string."
    },
    "assets_to_relate": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Relates the asset to all the assets specified in this array of up to 10 assets, specified by their asset IDs."
    }
  },
  "required": [
    "PCID",
    "asset_id",
    "assets_to_relate"
  ]
}

cloudinary_assets_create_asset_relations_by_public_id

Create asset relations by public ID Parameters:

Parameter	Type	Required	Default	Description
`resource_type`	string	Yes	—	The type of resource.
`type`	string	Yes	—	The delivery type of the asset.
`public_id`	string	Yes	—	The public ID of the asset.
`assets_to_relate`	string[]	Yes	—	Relates the asset to all the other assets specified in this array of up to 10 assets, specified as resource_type/type/public_id.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "resource_type": {
      "type": "string",
      "description": "The type of resource.",
      "enum": [
        "image",
        "video",
        "raw"
      ]
    },
    "type": {
      "type": "string",
      "description": "The delivery type of the asset.",
      "enum": [
        "upload",
        "private",
        "authenticated"
      ]
    },
    "public_id": {
      "type": "string",
      "description": "The public ID of the asset."
    },
    "assets_to_relate": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Relates the asset to all the other assets specified in this array of up to 10 assets, specified as resource_type/type/public_id."
    }
  },
  "required": [
    "PCID",
    "resource_type",
    "type",
    "public_id",
    "assets_to_relate"
  ]
}

cloudinary_assets_delete_asset_relations_by_asset_id

Delete asset relations by asset ID Parameters:

Parameter	Type	Required	Default	Description
`asset_id`	string	Yes	—	The asset ID of the resource. Must be a 32-character hexadecimal string.
`assets_to_unrelate`	string[]	Yes	—	Unrelates the asset from all the assets specified in this array of assets, specified by their asset IDs.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_id": {
      "type": "string",
      "description": "The asset ID of the resource. Must be a 32-character hexadecimal string."
    },
    "assets_to_unrelate": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Unrelates the asset from all the assets specified in this array of assets, specified by their asset IDs."
    }
  },
  "required": [
    "PCID",
    "asset_id",
    "assets_to_unrelate"
  ]
}

cloudinary_assets_delete_asset_relations_by_public_id

Delete asset relations by public ID Parameters:

Parameter	Type	Required	Default	Description
`resource_type`	string	Yes	—	The type of resource.
`type`	string	Yes	—	The delivery type of the asset.
`public_id`	string	Yes	—	The public ID of the asset.
`assets_to_unrelate`	string[]	Yes	—	Unrelates the asset from all the assets specified in this array of assets, specified as resource_type/type/public_id.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "resource_type": {
      "type": "string",
      "description": "The type of resource.",
      "enum": [
        "image",
        "video",
        "raw"
      ]
    },
    "type": {
      "type": "string",
      "description": "The delivery type of the asset.",
      "enum": [
        "upload",
        "private",
        "authenticated"
      ]
    },
    "public_id": {
      "type": "string",
      "description": "The public ID of the asset."
    },
    "assets_to_unrelate": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Unrelates the asset from all the assets specified in this array of assets, specified as resource_type/type/public_id."
    }
  },
  "required": [
    "PCID",
    "resource_type",
    "type",
    "public_id",
    "assets_to_unrelate"
  ]
}

cloudinary_assets_delete_backup_versions

Delete backed up versions Parameters:

Parameter	Type	Required	Default	Description
`asset_id`	string	Yes	—	The asset ID of the resource. Must be a 32-character hexadecimal string.
`version_ids`	string[]	Yes	—	The list of version IDs to delete from backup.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_id": {
      "type": "string",
      "description": "The asset ID of the resource. Must be a 32-character hexadecimal string."
    },
    "version_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The list of version IDs to delete from backup."
    }
  },
  "required": [
    "PCID",
    "asset_id",
    "version_ids"
  ]
}

cloudinary_assets_delete_resources_by_public_id

Delete resources by public ID Parameters:

Parameter	Type	Required	Default	Description
`resource_type`	string	Yes	—	The type of resource.
`type`	string	Yes	—	The extended storage type of the resource.
`all`	boolean	No	—	Delete all assets (of the relevant resource_type and type), including derived assets (up to a maximum of 1000 original resources).
`invalidate`	boolean	No	—	Whether to also invalidate the copies of the resource on the CDN. It usually takes between a few seconds and a few minutes for the invalidation to fully propagate through the CDN. Default: false.
`keep_original`	boolean	No	—	Whether to delete only the derived assets. Default: false.
`next_cursor`	string	No	—	(Only when deleting by prefix or all) When a deletion request has more than 1000 resources to delete, the response includes the partial boolean parameter set to true, as well as a next_cursor value. You can then specify this returned next_cursor value as a parameter of the following deletion request.
`prefix`	string	No	—	Delete all assets, including derived assets, where the public ID starts with the specified prefix (up to a maximum of 1000 original resources).
`public_ids`	string[]	No	—	A list of public IDs of the resources to delete.
`transformations`	string	No	—	Only the derived assets matching this hash of transformation parameters will be deleted. You can include multiple transformations separated by a pipe character (\|).

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "resource_type": {
      "type": "string",
      "description": "The type of resource.",
      "enum": [
        "image",
        "video",
        "raw"
      ]
    },
    "type": {
      "type": "string",
      "description": "The extended storage type of the resource.",
      "enum": [
        "upload",
        "private",
        "authenticated",
        "fetch",
        "list",
        "facebook",
        "twitter",
        "gravatar",
        "youtube",
        "hulu",
        "vimeo",
        "animoto",
        "worldstarhiphop",
        "dailymotion"
      ]
    },
    "all": {
      "type": "boolean",
      "description": "Delete all assets (of the relevant resource_type and type), including derived assets (up to a maximum of 1000 original resources)."
    },
    "invalidate": {
      "type": "boolean",
      "description": "Whether to also invalidate the copies of the resource on the CDN. It usually takes between a few seconds and a few minutes for the invalidation to fully propagate through the CDN. Default: false."
    },
    "keep_original": {
      "type": "boolean",
      "description": "Whether to delete only the derived assets. Default: false."
    },
    "next_cursor": {
      "type": "string",
      "description": "(Only when deleting by prefix or all) When a deletion request has more than 1000 resources to delete, the response includes the partial boolean parameter set to true, as well as a next_cursor value. You can then specify this returned next_cursor value as a parameter of the following deletion request."
    },
    "prefix": {
      "type": "string",
      "description": "Delete all assets, including derived assets, where the public ID starts with the specified prefix (up to a maximum of 1000 original resources)."
    },
    "public_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "A list of public IDs of the resources to delete."
    },
    "transformations": {
      "type": "string",
      "description": "Only the derived assets matching this hash of transformation parameters will be deleted. You can include multiple transformations separated by a pipe character (|)."
    }
  },
  "required": [
    "PCID",
    "resource_type",
    "type"
  ]
}

cloudinary_assets_derived_destroy

Delete derived resources Parameters:

Parameter	Type	Required	Default	Description
`derived_resource_ids`	string[]	Yes	—	Array of derived resource IDs to delete specific derived resources
`invalidate`	boolean	No	—	Whether to invalidate the CDN cache for the deleted resources

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "derived_resource_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of derived resource IDs to delete specific derived resources"
    },
    "invalidate": {
      "type": "boolean",
      "description": "Whether to invalidate the CDN cache for the deleted resources"
    }
  },
  "required": [
    "PCID",
    "derived_resource_ids"
  ]
}

cloudinary_assets_destroy_asset

Destroys an asset/resource Parameters:

Parameter	Type	Required	Default	Description
`resource_type`	string	Yes	—	The type of resource.
`invalidate`	boolean	No	—	Whether to invalidate CDN cached copies of the asset.
`public_id`	string	Yes	—	The public ID of the asset.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "resource_type": {
      "type": "string",
      "description": "The type of resource.",
      "enum": [
        "image",
        "video",
        "raw"
      ]
    },
    "invalidate": {
      "type": "boolean",
      "description": "Whether to invalidate CDN cached copies of the asset."
    },
    "public_id": {
      "type": "string",
      "description": "The public ID of the asset."
    }
  },
  "required": [
    "PCID",
    "resource_type",
    "public_id"
  ]
}

cloudinary_assets_destroy_by_asset_id

Delete asset by asset-id Parameters:

Parameter	Type	Required	Default	Description
`api_key`	string	No	—	The API key to use for the request. This is automatically computed by the Cloudinary’s SDKs.
`asset_id`	string	Yes	—	The ID of the asset to delete.
`callback`	string	No	—	URL for redirect after operation completion.
`invalidate`	boolean	No	—	Whether to invalidate CDN cache. Default is false.
`notification_url`	string	No	—	URL to receive completion notification.
`signature`	string	No	—	(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters.
`timestamp`	integer	No	—	The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary’s SDKs.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "api_key": {
      "type": "string",
      "description": "The API key to use for the request. This is automatically computed by the Cloudinary's SDKs."
    },
    "asset_id": {
      "type": "string",
      "description": "The ID of the asset to delete."
    },
    "callback": {
      "type": "string",
      "description": "URL for redirect after operation completion."
    },
    "invalidate": {
      "type": "boolean",
      "description": "Whether to invalidate CDN cache. Default is false."
    },
    "notification_url": {
      "type": "string",
      "description": "URL to receive completion notification."
    },
    "signature": {
      "type": "string",
      "description": "(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters."
    },
    "timestamp": {
      "type": "integer",
      "description": "The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs."
    }
  },
  "required": [
    "PCID",
    "asset_id"
  ]
}

cloudinary_assets_download_asset

Generates a download link for a specific asset (image) Parameters:

Parameter	Type	Required	Default	Description
`resource_type`	string	Yes	—	The type of resource.
`public_id`	string	Yes	—	The public ID of the asset.
`format`	string	No	—	The format to convert the asset to before downloading.
`type`	string	No	—	The storage type of the asset. Default is “upload”.
`expires_at`	integer	No	—	Unix timestamp indicating when the download URL should expire.
`attachment`	boolean	No	—	Whether to force download as an attachment.
`target_filename`	string	No	—	The desired filename for the downloaded file.
`transformation`	string	No	—	A transformation to apply to the asset before downloading.
`api_key`	string	No	—	The API key to use for the request. This is automatically computed by the Cloudinary’s SDKs.
`signature`	string	No	—	(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters.
`timestamp`	integer	No	—	The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary’s SDKs.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "resource_type": {
      "type": "string",
      "description": "The type of resource.",
      "enum": [
        "image",
        "video",
        "raw"
      ]
    },
    "public_id": {
      "type": "string",
      "description": "The public ID of the asset."
    },
    "format": {
      "type": "string",
      "description": "The format to convert the asset to before downloading."
    },
    "type": {
      "type": "string",
      "description": "The storage type of the asset. Default is \"upload\".",
      "enum": [
        "upload",
        "private",
        "authenticated"
      ]
    },
    "expires_at": {
      "type": "integer",
      "description": "Unix timestamp indicating when the download URL should expire."
    },
    "attachment": {
      "type": "boolean",
      "description": "Whether to force download as an attachment."
    },
    "target_filename": {
      "type": "string",
      "description": "The desired filename for the downloaded file."
    },
    "transformation": {
      "type": "string",
      "description": "A transformation to apply to the asset before downloading."
    },
    "api_key": {
      "type": "string",
      "description": "The API key to use for the request. This is automatically computed by the Cloudinary's SDKs."
    },
    "signature": {
      "type": "string",
      "description": "(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters."
    },
    "timestamp": {
      "type": "integer",
      "description": "The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs."
    }
  },
  "required": [
    "PCID",
    "resource_type",
    "public_id"
  ]
}

cloudinary_assets_download_backup_asset

Download a backup copy of an asset Parameters:

Parameter	Type	Required	Default	Description
`asset_id`	string	Yes	—	The asset ID of the resource. Must be a 32-character hexadecimal string.
`version_id`	string	Yes	—	The version ID of the backup to download. Must be a 32-character hexadecimal string.
`api_key`	string	No	—	The API key to use for the request. This is automatically computed by the Cloudinary’s SDKs.
`signature`	string	No	—	(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters.
`timestamp`	integer	No	—	The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary’s SDKs.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_id": {
      "type": "string",
      "description": "The asset ID of the resource. Must be a 32-character hexadecimal string."
    },
    "version_id": {
      "type": "string",
      "description": "The version ID of the backup to download. Must be a 32-character hexadecimal string."
    },
    "api_key": {
      "type": "string",
      "description": "The API key to use for the request. This is automatically computed by the Cloudinary's SDKs."
    },
    "signature": {
      "type": "string",
      "description": "(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters."
    },
    "timestamp": {
      "type": "integer",
      "description": "The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs."
    }
  },
  "required": [
    "PCID",
    "asset_id",
    "version_id"
  ]
}

cloudinary_assets_explicit_asset

Apply operations on an existing asset Parameters:

Parameter	Type	Required	Default	Description
`resource_type`	string	Yes	—	The type of resource.
`accessibility_analysis`	boolean	No	—	Whether to return return accessibility analysis values for the image.
`api_key`	string	No	—	The API key to use for the request. This is automatically computed by the Cloudinary’s SDKs.
`asset_folder`	string	No	—	The asset folder to assign to the asset.
`async`	boolean	No	—	When set to true, returns the uploaded asset’s public_id immediately in the response, before the upload is completed (asynchronously). Default: false.
`auto_chaptering`	boolean	No	—	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.
`auto_transcription`	object	No	—	Auto Transcription
`callback`	string	No	—	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.
`cinemagraph_analysis`	boolean	No	—	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.
`colors`	boolean	No	—	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.
`context`	string	No	—	Key-value pairs of general textual context metadata to attach to the asset.
`custom_coordinates`	string	No	—	An array of coordinates for custom cropping.
`display_name`	string	No	—	A display name for the asset.
`eager`	string	No	—	A list of transformations to eagerly generate for the asset. Accepts either a single transformation or a pipe-separated list of transformations.
`eager_async`	boolean	No	—	Whether to generate the eager transformations asynchronously in the background after the upload request is completed rather than before the upload is completed.
`eager_notification_url`	string	No	—	A URL to notify when eager transformations are completed.
`face_coordinates`	string	No	—	An array of coordinates representing detected faces in the asset, used for custom cropping or overlays.
`faces`	boolean	No	—	Whether to detect faces in the asset.
`headers`	string	No	—	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.
`invalidate`	boolean	No	—	Whether to invalidate CDN cache copies of a previously uploaded asset that shares the same public ID. Default: false.
`media_metadata`	boolean	No	—	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.
`metadata`	string	No	—	Structured metadata to attach to the asset based on the metadata fields defined for your account.
`moderation`	string	No	—	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.
`notification_url`	string	No	—	A URL to notify when the asset is ready.
`overwrite`	boolean	No	—	When applying eager for already existing video transformations, this setting indicates whether to force the existing derived video resources to be regenerated. Default for videos: false. Note: When specifying existing eager transformations for images, corresponding derived images are always regenerated.
`phash`	boolean	No	—	Whether to return the perceptual hash (pHash) on the uploaded image for image similarity detection.
`public_id`	string	Yes	—	The public ID of the existing asset to apply operations on.
`quality_analysis`	boolean	No	—	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.
`quality_override`	object	No	—	Override the quality setting for this asset.
`regions`	string	No	—	Regions to detect in the asset.
`responsive_breakpoints`	object[]	No	—	Settings to automatically generate breakpoints for responsive images.
`signature`	string	No	—	(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters.
`tags`	string	No	—	A comma-separated list of tag names to assign to the asset.
`timestamp`	integer	No	—	The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary’s SDKs.
`type`	string	No	—	The storage type of resources to include in the archive.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "resource_type": {
      "type": "string",
      "description": "The type of resource.",
      "enum": [
        "image",
        "video",
        "raw"
      ]
    },
    "accessibility_analysis": {
      "type": "boolean",
      "description": "Whether to return return accessibility analysis values for the image."
    },
    "api_key": {
      "type": "string",
      "description": "The API key to use for the request. This is automatically computed by the Cloudinary's SDKs."
    },
    "asset_folder": {
      "type": "string",
      "description": "The asset folder to assign to the asset."
    },
    "async": {
      "type": "boolean",
      "description": "When set to true, returns the uploaded asset's public_id immediately in the response, before the upload is completed (asynchronously). Default: false."
    },
    "auto_chaptering": {
      "type": "boolean",
      "description": "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."
    },
    "auto_transcription": {
      "description": "Auto Transcription"
    },
    "callback": {
      "type": "string",
      "description": "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."
    },
    "cinemagraph_analysis": {
      "type": "boolean",
      "description": "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."
    },
    "colors": {
      "type": "boolean",
      "description": "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."
    },
    "context": {
      "type": "string",
      "description": "Key-value pairs of general textual context metadata to attach to the asset."
    },
    "custom_coordinates": {
      "type": "string",
      "description": "An array of coordinates for custom cropping."
    },
    "display_name": {
      "type": "string",
      "description": "A display name for the asset."
    },
    "eager": {
      "type": "string",
      "description": "A list of transformations to eagerly generate for the asset. Accepts either a single transformation or a pipe-separated list of transformations."
    },
    "eager_async": {
      "type": "boolean",
      "description": "Whether to generate the eager transformations asynchronously in the background after the upload request is completed rather than before the upload is completed."
    },
    "eager_notification_url": {
      "type": "string",
      "description": "A URL to notify when eager transformations are completed."
    },
    "face_coordinates": {
      "type": "string",
      "description": "An array of coordinates representing detected faces in the asset, used for custom cropping or overlays."
    },
    "faces": {
      "type": "boolean",
      "description": "Whether to detect faces in the asset."
    },
    "headers": {
      "type": "string",
      "description": "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."
    },
    "invalidate": {
      "type": "boolean",
      "description": "Whether to invalidate CDN cache copies of a previously uploaded asset that shares the same public ID. Default: false."
    },
    "media_metadata": {
      "type": "boolean",
      "description": "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."
    },
    "metadata": {
      "type": "string",
      "description": "Structured metadata to attach to the asset based on the metadata fields defined for your account."
    },
    "moderation": {
      "type": "string",
      "description": "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."
    },
    "notification_url": {
      "type": "string",
      "description": "A URL to notify when the asset is ready."
    },
    "overwrite": {
      "type": "boolean",
      "description": "When applying eager for already existing video transformations, this setting indicates whether to force the existing derived video resources to be regenerated. Default for videos: false. Note: When specifying existing eager transformations for images, corresponding derived images are always regenerated."
    },
    "phash": {
      "type": "boolean",
      "description": "Whether to return the perceptual hash (pHash) on the uploaded image for image similarity detection."
    },
    "public_id": {
      "type": "string",
      "description": "The public ID of the existing asset to apply operations on."
    },
    "quality_analysis": {
      "type": "boolean",
      "description": "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."
    },
    "quality_override": {
      "description": "Override the quality setting for this asset."
    },
    "regions": {
      "type": "string",
      "description": "Regions to detect in the asset."
    },
    "responsive_breakpoints": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "create_derived": {
            "type": "boolean",
            "description": "Create Derived"
          },
          "max_width": {
            "type": "integer",
            "description": "Max Width"
          },
          "min_width": {
            "type": "integer",
            "description": "Min Width"
          },
          "bytes_step": {
            "type": "integer",
            "description": "Bytes Step"
          },
          "max_images": {
            "type": "integer",
            "description": "Max Images"
          },
          "transformation": {
            "type": "string",
            "description": "The transformation value"
          }
        }
      },
      "description": "Settings to automatically generate breakpoints for responsive images."
    },
    "signature": {
      "type": "string",
      "description": "(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters."
    },
    "tags": {
      "type": "string",
      "description": "A comma-separated list of tag names to assign to the asset."
    },
    "timestamp": {
      "type": "integer",
      "description": "The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs."
    },
    "type": {
      "type": "string",
      "description": "The storage type of resources to include in the archive.",
      "enum": [
        "upload",
        "private",
        "authenticated",
        "fetch"
      ]
    }
  },
  "required": [
    "PCID",
    "resource_type",
    "public_id"
  ]
}

cloudinary_assets_explode_resource

Create derived images from multi-page file Parameters:

Parameter	Type	Required	Default	Description
`resource_type`	string	Yes	—	The type of resource to explode. Only “image” is supported.
`api_key`	string	No	—	The API key to use for the request. This is automatically computed by the Cloudinary’s SDKs.
`format`	string	No	—	The format for the generated derived images. Default: png
`notification_url`	string	No	—	The webhook URL to notify when the operation is complete.
`public_id`	string	Yes	—	The public ID of the PDF or animated image to generate from.
`signature`	string	No	—	(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters.
`timestamp`	integer	No	—	The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary’s SDKs.
`transformation`	string	Yes	—	The transformation to apply. Must contain exactly one pg_all transformation parameter.
`type`	string	No	—	The storage type of the resource.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "resource_type": {
      "type": "string",
      "description": "The type of resource to explode. Only \"image\" is supported.",
      "enum": [
        "image"
      ]
    },
    "api_key": {
      "type": "string",
      "description": "The API key to use for the request. This is automatically computed by the Cloudinary's SDKs."
    },
    "format": {
      "type": "string",
      "description": "The format for the generated derived images. Default: png"
    },
    "notification_url": {
      "type": "string",
      "description": "The webhook URL to notify when the operation is complete."
    },
    "public_id": {
      "type": "string",
      "description": "The public ID of the PDF or animated image to generate from."
    },
    "signature": {
      "type": "string",
      "description": "(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters."
    },
    "timestamp": {
      "type": "integer",
      "description": "The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs."
    },
    "transformation": {
      "type": "string",
      "description": "The transformation to apply. Must contain exactly one pg_all transformation parameter."
    },
    "type": {
      "type": "string",
      "description": "The storage type of the resource.",
      "enum": [
        "upload",
        "private",
        "authenticated"
      ]
    }
  },
  "required": [
    "PCID",
    "resource_type",
    "public_id",
    "transformation"
  ]
}

cloudinary_assets_generate_archive

Creates an archive (ZIP or TGZ file) that contains a set of assets from your product environment. Parameters:

Parameter	Type	Required	Default	Description
`resource_type`	string	Yes	—	The type of resources to include in the archive. “image” for images, “video” for videos, “raw” for non-media files, or “all” for mixed types.
`allow_missing`	boolean	No	—	Whether to allow missing assets in the archive. If false, the operation will fail if any asset is not found.
`api_key`	string	No	—	The API key to use for the request. This is automatically computed by the Cloudinary’s SDKs.
`async`	boolean	No	—	(“create” mode only), specifies whether to generate the archive asynchronously.
`expires_at`	integer	No	—	(“download” mode only) Unix timestamp indicating when the generated archive URL should expire.
`flatten_folders`	boolean	No	—	Whether to flatten all files to be in the root of the archive file.
`flatten_transformations`	boolean	No	—	Whether to flatten the folder structure of the derived assets.
`keep_derived`	boolean	No	—	Whether to keep the derived assets used for generating the archive.
`mode`	string	No	—	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
`notification_url`	string	No	—	(“create” mode only), specifies the URL to notify when the archive generation is complete.
`prefixes`	string[]	No	—	Select all assets where the public ID starts with this prefix. Up to 20 prefixes are supported.
`public_ids`	string[]	No	—	The list of public IDs to include in the archive. Up to 1000 public IDs are supported.
`signature`	string	No	—	(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters.
`skip_transformation_name`	boolean	No	—	Whether to skip adding the transformation details to the file names in the archive.
`tags`	string[]	No	—	A tag to use for selecting assets to include in the archive. Up to 20 tags are supported.
`target_asset_folder`	string	No	—	The folder in your product environment where the generated archive should be stored.
`target_format`	string	No	—	The format of the generated archive.
`target_public_id`	string	No	—	The public ID to assign to the generated archive, or the filename of the downloaded archive file.
`target_tags`	string[]	No	—	A list of tag names to assign to the generated archive.
`timestamp`	integer	No	—	The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary’s SDKs.
`transformations`	string	No	—	The transformations to apply to the assets before including them in the archive (separated by ”\|”).
`type`	string	No	—	The storage type of resources to include in the archive.
`use_original_filename`	boolean	No	—	Whether to use the original filenames of the assets in the archive instead of public IDs (when available).

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "resource_type": {
      "type": "string",
      "description": "The type of resources to include in the archive. \"image\" for images, \"video\" for videos, \"raw\" for non-media files, or \"all\" for mixed types.",
      "enum": [
        "image",
        "video",
        "raw",
        "all"
      ]
    },
    "allow_missing": {
      "type": "boolean",
      "description": "Whether to allow missing assets in the archive. If false, the operation will fail if any asset is not found."
    },
    "api_key": {
      "type": "string",
      "description": "The API key to use for the request. This is automatically computed by the Cloudinary's SDKs."
    },
    "async": {
      "type": "boolean",
      "description": "(\"create\" mode only), specifies whether to generate the archive asynchronously."
    },
    "expires_at": {
      "type": "integer",
      "description": "(\"download\" mode only) Unix timestamp indicating when the generated archive URL should expire."
    },
    "flatten_folders": {
      "type": "boolean",
      "description": "Whether to flatten all files to be in the root of the archive file."
    },
    "flatten_transformations": {
      "type": "boolean",
      "description": "Whether to flatten the folder structure of the derived assets."
    },
    "keep_derived": {
      "type": "boolean",
      "description": "Whether to keep the derived assets used for generating the archive."
    },
    "mode": {
      "type": "string",
      "description": "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",
      "enum": [
        "download",
        "create",
        "create_and_download"
      ]
    },
    "notification_url": {
      "type": "string",
      "description": "(\"create\" mode only), specifies the URL to notify when the archive generation is complete."
    },
    "prefixes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Select all assets where the public ID starts with this prefix. Up to 20 prefixes are supported."
    },
    "public_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The list of public IDs to include in the archive. Up to 1000 public IDs are supported."
    },
    "signature": {
      "type": "string",
      "description": "(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters."
    },
    "skip_transformation_name": {
      "type": "boolean",
      "description": "Whether to skip adding the transformation details to the file names in the archive."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "A tag to use for selecting assets to include in the archive. Up to 20 tags are supported."
    },
    "target_asset_folder": {
      "type": "string",
      "description": "The folder in your product environment where the generated archive should be stored."
    },
    "target_format": {
      "type": "string",
      "description": "The format of the generated archive.",
      "enum": [
        "zip",
        "tgz"
      ]
    },
    "target_public_id": {
      "type": "string",
      "description": "The public ID to assign to the generated archive, or the filename of the downloaded archive file."
    },
    "target_tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "A list of tag names to assign to the generated archive."
    },
    "timestamp": {
      "type": "integer",
      "description": "The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs."
    },
    "transformations": {
      "type": "string",
      "description": "The transformations to apply to the assets before including them in the archive (separated by \"|\")."
    },
    "type": {
      "type": "string",
      "description": "The storage type of resources to include in the archive.",
      "enum": [
        "upload",
        "private",
        "authenticated",
        "fetch"
      ]
    },
    "use_original_filename": {
      "type": "boolean",
      "description": "Whether to use the original filenames of the assets in the archive instead of public IDs (when available)."
    }
  },
  "required": [
    "PCID",
    "resource_type"
  ]
}

cloudinary_assets_get_resource_by_asset_id

Get resource by asset ID Parameters:

Parameter	Type	Required	Default	Description
`asset_id`	string	Yes	—	The asset ID of the resource. Must be a 32-character hexadecimal string.
`colors`	boolean	No	—	Whether to include color information (predominant colors and histogram of 32 leading colors). Default: false.
`media_metadata`	boolean	No	—	Whether to include IPTC, XMP, and detailed Exif metadata in the response. Default: false.
`faces`	boolean	No	—	Whether to include a list of coordinates of detected faces. Default: false.
`quality_analysis`	boolean	No	—	Whether to return quality analysis scores for the image. Default: false.
`accessibility_analysis`	boolean	No	—	Whether to return accessibility analysis scores for the image. Default: false.
`pages`	boolean	No	—	Whether to report the number of pages in multi-page documents (e.g., PDF). Default: false.
`phash`	boolean	No	—	Whether to include the perceptual hash (pHash) of the uploaded photo for image similarity detection. Default: false.
`coordinates`	boolean	No	—	Whether to include previously specified custom cropping coordinates and faces coordinates. Default: false.
`versions`	boolean	No	—	Whether to include details of all the backed up versions of the asset. Default: false.
`max_results`	integer	No	—	Maximum number of derived assets to return. Default: 10.
`derived_next_cursor`	string	No	—	The cursor for the next page of derived assets when there are more derived images than max_results.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_id": {
      "type": "string",
      "description": "The asset ID of the resource. Must be a 32-character hexadecimal string."
    },
    "colors": {
      "type": "boolean",
      "description": "Whether to include color information (predominant colors and histogram of 32 leading colors). Default: false."
    },
    "media_metadata": {
      "type": "boolean",
      "description": "Whether to include IPTC, XMP, and detailed Exif metadata in the response. Default: false."
    },
    "faces": {
      "type": "boolean",
      "description": "Whether to include a list of coordinates of detected faces. Default: false."
    },
    "quality_analysis": {
      "type": "boolean",
      "description": "Whether to return quality analysis scores for the image. Default: false."
    },
    "accessibility_analysis": {
      "type": "boolean",
      "description": "Whether to return accessibility analysis scores for the image. Default: false."
    },
    "pages": {
      "type": "boolean",
      "description": "Whether to report the number of pages in multi-page documents (e.g., PDF). Default: false."
    },
    "phash": {
      "type": "boolean",
      "description": "Whether to include the perceptual hash (pHash) of the uploaded photo for image similarity detection. Default: false."
    },
    "coordinates": {
      "type": "boolean",
      "description": "Whether to include previously specified custom cropping coordinates and faces coordinates. Default: false."
    },
    "versions": {
      "type": "boolean",
      "description": "Whether to include details of all the backed up versions of the asset. Default: false."
    },
    "max_results": {
      "type": "integer",
      "description": "Maximum number of derived assets to return. Default: 10."
    },
    "derived_next_cursor": {
      "type": "string",
      "description": "The cursor for the next page of derived assets when there are more derived images than max_results."
    }
  },
  "required": [
    "PCID",
    "asset_id"
  ]
}

cloudinary_assets_get_resource_by_public_id

Get resource by public ID Parameters:

Parameter	Type	Required	Default	Description
`resource_type`	string	Yes	—	The type of resource.
`type`	string	Yes	—	The extended storage type of the resource.
`public_id`	string	Yes	—	The public ID of the asset.
`colors`	boolean	No	—	Whether to include color information (predominant colors and histogram of 32 leading colors). Default: false.
`media_metadata`	boolean	No	—	Whether to include IPTC, XMP, and detailed Exif metadata in the response. Default: false.
`faces`	boolean	No	—	Whether to include a list of coordinates of detected faces. Default: false.
`quality_analysis`	boolean	No	—	Whether to return quality analysis scores for the image. Default: false.
`accessibility_analysis`	boolean	No	—	Whether to return accessibility analysis scores for the image. Default: false.
`pages`	boolean	No	—	Whether to report the number of pages in multi-page documents (e.g., PDF). Default: false.
`phash`	boolean	No	—	Whether to include the perceptual hash (pHash) of the uploaded photo for image similarity detection. Default: false.
`coordinates`	boolean	No	—	Whether to include previously specified custom cropping coordinates and faces coordinates. Default: false.
`versions`	boolean	No	—	Whether to include details of all the backed up versions of the asset. Default: false.
`max_results`	integer	No	—	Maximum number of derived assets to return. Default: 10.
`derived_next_cursor`	string	No	—	The cursor for the next page of derived assets when there are more derived images than max_results.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "resource_type": {
      "type": "string",
      "description": "The type of resource.",
      "enum": [
        "image",
        "video",
        "raw"
      ]
    },
    "type": {
      "type": "string",
      "description": "The extended storage type of the resource.",
      "enum": [
        "upload",
        "private",
        "authenticated",
        "fetch",
        "list",
        "facebook",
        "twitter",
        "gravatar",
        "youtube",
        "hulu",
        "vimeo",
        "animoto",
        "worldstarhiphop",
        "dailymotion"
      ]
    },
    "public_id": {
      "type": "string",
      "description": "The public ID of the asset."
    },
    "colors": {
      "type": "boolean",
      "description": "Whether to include color information (predominant colors and histogram of 32 leading colors). Default: false."
    },
    "media_metadata": {
      "type": "boolean",
      "description": "Whether to include IPTC, XMP, and detailed Exif metadata in the response. Default: false."
    },
    "faces": {
      "type": "boolean",
      "description": "Whether to include a list of coordinates of detected faces. Default: false."
    },
    "quality_analysis": {
      "type": "boolean",
      "description": "Whether to return quality analysis scores for the image. Default: false."
    },
    "accessibility_analysis": {
      "type": "boolean",
      "description": "Whether to return accessibility analysis scores for the image. Default: false."
    },
    "pages": {
      "type": "boolean",
      "description": "Whether to report the number of pages in multi-page documents (e.g., PDF). Default: false."
    },
    "phash": {
      "type": "boolean",
      "description": "Whether to include the perceptual hash (pHash) of the uploaded photo for image similarity detection. Default: false."
    },
    "coordinates": {
      "type": "boolean",
      "description": "Whether to include previously specified custom cropping coordinates and faces coordinates. Default: false."
    },
    "versions": {
      "type": "boolean",
      "description": "Whether to include details of all the backed up versions of the asset. Default: false."
    },
    "max_results": {
      "type": "integer",
      "description": "Maximum number of derived assets to return. Default: 10."
    },
    "derived_next_cursor": {
      "type": "string",
      "description": "The cursor for the next page of derived assets when there are more derived images than max_results."
    }
  },
  "required": [
    "PCID",
    "resource_type",
    "type",
    "public_id"
  ]
}

cloudinary_assets_get_video_views

Get video views Parameters:

Parameter	Type	Required	Default	Description
`expression`	string	No	—	A set of conditions used to limit the results to rows that match those conditions. For example: `?expression=video_public_id=skate`
`max_results`	integer	No	—	The maximum number of results to return. Default is 10.
`sort_by`	string	No	—	Specifies the expression field by which to sort the results. Prepend values with a ’-’ to reverse the order.
`next_cursor`	string	No	—	The cursor for pagination. Use the next_cursor value from a previous response to get the next page of results.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "expression": {
      "type": "string",
      "description": "A set of conditions used to limit the results to rows that match those conditions. For example: `?expression=video_public_id=skate`"
    },
    "max_results": {
      "type": "integer",
      "description": "The maximum number of results to return. Default is 10."
    },
    "sort_by": {
      "type": "string",
      "description": "Specifies the expression field by which to sort the results. Prepend values with a '-' to reverse the order.",
      "enum": [
        "view_ended_at",
        "video_duration",
        "view_watch_time",
        "-view_ended_at",
        "-video_duration",
        "-view_watch_time"
      ]
    },
    "next_cursor": {
      "type": "string",
      "description": "The cursor for pagination. Use the next_cursor value from a previous response to get the next page of results."
    }
  },
  "required": [
    "PCID"
  ]
}

cloudinary_assets_list_images

Get image assets Parameters:

Parameter	Type	Required	Default	Description
`type`	string	No	—	The storage type of the assets. Necessary for prefix filtering.
`prefix`	string	No	—	Find resources with a public ID prefix. Requires the `type` parameter.
`public_ids`	string[]	No	—	An array of public IDs to return.
`tags`	boolean	No	—	Whether to include the list of tag names assigned to each asset. Default: false
`next_cursor`	string	No	—	Cursor for pagination.
`max_results`	integer	No	—	Maximum number of results to return (1-500).
`direction`	string	No	—	Sort direction.
`start_at`	string	No	—	Retrieve resources uploaded after this timestamp.
`fields`	string[]	No	—	A comma-separated list of fields to include in the response. The following fields are always included in the response: public_id, and asset_id.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "type": {
      "type": "string",
      "description": "The storage type of the assets. Necessary for prefix filtering.",
      "enum": [
        "upload",
        "private",
        "authenticated",
        "fetch",
        "list"
      ]
    },
    "prefix": {
      "type": "string",
      "description": "Find resources with a public ID prefix. Requires the `type` parameter."
    },
    "public_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "An array of public IDs to return."
    },
    "tags": {
      "type": "boolean",
      "description": "Whether to include the list of tag names assigned to each asset. Default: false"
    },
    "next_cursor": {
      "type": "string",
      "description": "Cursor for pagination."
    },
    "max_results": {
      "type": "integer",
      "description": "Maximum number of results to return (1-500)."
    },
    "direction": {
      "type": "string",
      "description": "Sort direction.",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "start_at": {
      "type": "string",
      "description": "Retrieve resources uploaded after this timestamp."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "asset_folder",
          "folder",
          "filename",
          "format",
          "version",
          "version_id",
          "signature",
          "resource_type",
          "created_at",
          "uploaded_at",
          "bytes",
          "backup_bytes",
          "width",
          "height",
          "aspect_ratio",
          "access_control",
          "metadata",
          "context",
          "tags",
          "pixels",
          "custom",
          "moderation",
          "url",
          "secure_url",
          "status",
          "etag"
        ]
      },
      "description": "A comma-separated list of fields to include in the response. The following fields are always included in the response: public_id, and asset_id."
    }
  },
  "required": [
    "PCID"
  ]
}

cloudinary_assets_list_raw_files

Get raw assets Parameters:

Parameter	Type	Required	Default	Description
`type`	string	No	—	The storage type of the assets. Necessary for prefix filtering.
`prefix`	string	No	—	A public_id prefix. When specified, all assets with that prefix are returned. When using this, the `type` parameter must also be specified.
`public_ids`	string[]	No	—	An array of public IDs to return.
`tags`	boolean	No	—	Whether to include the list of tag names assigned to each asset. Default: false
`next_cursor`	string	No	—	Cursor for pagination.
`max_results`	integer	No	—	Maximum number of results to return (1-500).
`direction`	string	No	—	Sort direction.
`start_at`	string	No	—	An ISO-8601 formatted timestamp. When specified, assets created since that timestamp are returned. Supported only if neither `prefix` nor `public_ids` were passed.
`fields`	string[]	No	—	A comma-separated list of fields to include in the response. The following fields are always included in the response: public_id, and asset_id.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "type": {
      "type": "string",
      "description": "The storage type of the assets. Necessary for prefix filtering.",
      "enum": [
        "upload",
        "private",
        "authenticated",
        "fetch",
        "list"
      ]
    },
    "prefix": {
      "type": "string",
      "description": "A public_id prefix. When specified, all assets with that prefix are returned. When using this, the `type` parameter must also be specified."
    },
    "public_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "An array of public IDs to return."
    },
    "tags": {
      "type": "boolean",
      "description": "Whether to include the list of tag names assigned to each asset. Default: false"
    },
    "next_cursor": {
      "type": "string",
      "description": "Cursor for pagination."
    },
    "max_results": {
      "type": "integer",
      "description": "Maximum number of results to return (1-500)."
    },
    "direction": {
      "type": "string",
      "description": "Sort direction.",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "start_at": {
      "type": "string",
      "description": "An ISO-8601 formatted timestamp. When specified, assets created since that timestamp are returned.  Supported only if neither `prefix` nor `public_ids` were passed."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "asset_folder",
          "folder",
          "filename",
          "format",
          "version",
          "version_id",
          "signature",
          "resource_type",
          "created_at",
          "uploaded_at",
          "bytes",
          "backup_bytes",
          "width",
          "height",
          "aspect_ratio",
          "access_control",
          "metadata",
          "context",
          "tags",
          "pixels",
          "custom",
          "moderation",
          "url",
          "secure_url",
          "status",
          "etag"
        ]
      },
      "description": "A comma-separated list of fields to include in the response. The following fields are always included in the response: public_id, and asset_id."
    }
  },
  "required": [
    "PCID"
  ]
}

cloudinary_assets_list_resource_tags

Retrieves a list of tags currently applied to assets in your Cloudinary account Parameters:

Parameter	Type	Required	Default	Description
`resource_type`	string	Yes	—	The type of resource.
`prefix`	string	No	—	The prefix to use if you want to limit the returned tags to those that start with the specified prefix.
`next_cursor`	string	No	—	Cursor for pagination.
`max_results`	integer	No	—	Maximum number of results to return (1-500).

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "resource_type": {
      "type": "string",
      "description": "The type of resource.",
      "enum": [
        "image",
        "video",
        "raw"
      ]
    },
    "prefix": {
      "type": "string",
      "description": "The prefix to use if you want to limit the returned tags to those that start with the specified prefix."
    },
    "next_cursor": {
      "type": "string",
      "description": "Cursor for pagination."
    },
    "max_results": {
      "type": "integer",
      "description": "Maximum number of results to return (1-500)."
    }
  },
  "required": [
    "PCID",
    "resource_type"
  ]
}

cloudinary_assets_list_resource_types

Get resource types

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    }
  },
  "required": [
    "PCID"
  ]
}

cloudinary_assets_list_resources_by_asset_folder

Get resources by asset folder Parameters:

Parameter	Type	Required	Default	Description
`asset_folder`	string	Yes	—	The full path of the asset folder.
`resource_type`	string	No	—	Filter by resource type within the folder.
`next_cursor`	string	No	—	Cursor for pagination.
`max_results`	integer	No	—	Maximum number of results to return (1-500).
`direction`	string	No	—	Sort direction.
`fields`	string[]	No	—	A comma-separated list of fields to include in the response. The following fields are always included in the response: public_id, and asset_id.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_folder": {
      "type": "string",
      "description": "The full path of the asset folder."
    },
    "resource_type": {
      "type": "string",
      "description": "Filter by resource type within the folder.",
      "enum": [
        "image",
        "video",
        "raw"
      ]
    },
    "next_cursor": {
      "type": "string",
      "description": "Cursor for pagination."
    },
    "max_results": {
      "type": "integer",
      "description": "Maximum number of results to return (1-500)."
    },
    "direction": {
      "type": "string",
      "description": "Sort direction.",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "asset_folder",
          "folder",
          "filename",
          "format",
          "version",
          "version_id",
          "signature",
          "resource_type",
          "created_at",
          "uploaded_at",
          "bytes",
          "backup_bytes",
          "width",
          "height",
          "aspect_ratio",
          "access_control",
          "metadata",
          "context",
          "tags",
          "pixels",
          "custom",
          "moderation",
          "url",
          "secure_url",
          "status",
          "etag"
        ]
      },
      "description": "A comma-separated list of fields to include in the response. The following fields are always included in the response: public_id, and asset_id."
    }
  },
  "required": [
    "PCID",
    "asset_folder"
  ]
}

cloudinary_assets_list_resources_by_asset_ids

Get resources by asset IDs Parameters:

Parameter	Type	Required	Default	Description
`asset_ids`	string[]	Yes	—	List of asset IDs to retrieve (max 100).
`resource_type`	string	No	—	Resource type (optional, can sometimes disambiguate).
`fields`	string[]	No	—	A comma-separated list of fields to include in the response. The following fields are always included in the response: public_id, and asset_id.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of asset IDs to retrieve (max 100)."
    },
    "resource_type": {
      "type": "string",
      "description": "Resource type (optional, can sometimes disambiguate).",
      "enum": [
        "image",
        "video",
        "raw"
      ]
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "asset_folder",
          "folder",
          "filename",
          "format",
          "version",
          "version_id",
          "signature",
          "resource_type",
          "created_at",
          "uploaded_at",
          "bytes",
          "backup_bytes",
          "width",
          "height",
          "aspect_ratio",
          "access_control",
          "metadata",
          "context",
          "tags",
          "pixels",
          "custom",
          "moderation",
          "url",
          "secure_url",
          "status",
          "etag"
        ]
      },
      "description": "A comma-separated list of fields to include in the response. The following fields are always included in the response: public_id, and asset_id."
    }
  },
  "required": [
    "PCID",
    "asset_ids"
  ]
}

cloudinary_assets_list_resources_by_context

Get resources by context Parameters:

Parameter	Type	Required	Default	Description
`resource_type`	string	Yes	—	The type of resource.
`key`	string	Yes	—	Context key to filter by.
`value`	string	No	—	Context value to filter by.
`next_cursor`	string	No	—	Cursor for pagination.
`max_results`	integer	No	—	Maximum number of results to return (1-500).
`direction`	string	No	—	Sort direction.
`fields`	string[]	No	—	A comma-separated list of fields to include in the response. The following fields are always included in the response: public_id, and asset_id.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "resource_type": {
      "type": "string",
      "description": "The type of resource.",
      "enum": [
        "image",
        "video",
        "raw"
      ]
    },
    "key": {
      "type": "string",
      "description": "Context key to filter by."
    },
    "value": {
      "type": "string",
      "description": "Context value to filter by."
    },
    "next_cursor": {
      "type": "string",
      "description": "Cursor for pagination."
    },
    "max_results": {
      "type": "integer",
      "description": "Maximum number of results to return (1-500)."
    },
    "direction": {
      "type": "string",
      "description": "Sort direction.",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "asset_folder",
          "folder",
          "filename",
          "format",
          "version",
          "version_id",
          "signature",
          "resource_type",
          "created_at",
          "uploaded_at",
          "bytes",
          "backup_bytes",
          "width",
          "height",
          "aspect_ratio",
          "access_control",
          "metadata",
          "context",
          "tags",
          "pixels",
          "custom",
          "moderation",
          "url",
          "secure_url",
          "status",
          "etag"
        ]
      },
      "description": "A comma-separated list of fields to include in the response. The following fields are always included in the response: public_id, and asset_id."
    }
  },
  "required": [
    "PCID",
    "resource_type",
    "key"
  ]
}

cloudinary_assets_list_resources_by_external_ids

Get resources by external IDs Parameters:

Parameter	Type	Required	Default	Description
`external_ids`	string[]	Yes	—	List of external IDs for identifying the assets to retrieve. Either external_ids or asset_ids must be provided.
`resource_type`	string	No	—	Resource type (optional).
`fields`	string[]	No	—	A comma-separated list of fields to include in the response. Notes: This parameter takes precedence over other parameters requesting details in the response (e.g., tags or context), so include them in this list if you also want their details returned. The following fields are always included in the response: public_id, and asset_id.
`tags`	boolean	No	—	Whether to include the list of tag names assigned to each asset. Default: false.
`context`	boolean	No	—	Whether to include key-value pairs of contextual metadata associated with each asset. Default: false.
`metadata`	boolean	No	—	Whether to include the structured metadata fields and values assigned to each asset. Default: false.
`moderations`	boolean	No	—	Whether to include image moderation status of each asset. Default: false.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "external_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of external IDs for identifying the assets to retrieve. Either external_ids or asset_ids must be provided."
    },
    "resource_type": {
      "type": "string",
      "description": "Resource type (optional).",
      "enum": [
        "image",
        "video",
        "raw"
      ]
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "asset_folder",
          "folder",
          "filename",
          "format",
          "version",
          "version_id",
          "signature",
          "resource_type",
          "created_at",
          "uploaded_at",
          "bytes",
          "backup_bytes",
          "width",
          "height",
          "aspect_ratio",
          "access_control",
          "metadata",
          "context",
          "tags",
          "pixels",
          "custom",
          "moderation",
          "url",
          "secure_url",
          "status",
          "etag"
        ]
      },
      "description": "A comma-separated list of fields to include in the response. Notes: This parameter takes precedence over other parameters requesting details in the response (e.g., tags or context), so include them in this list if you also want their details returned. The following fields are always included in the response: public_id, and asset_id."
    },
    "tags": {
      "type": "boolean",
      "description": "Whether to include the list of tag names assigned to each asset. Default: false."
    },
    "context": {
      "type": "boolean",
      "description": "Whether to include key-value pairs of contextual metadata associated with each asset. Default: false."
    },
    "metadata": {
      "type": "boolean",
      "description": "Whether to include the structured metadata fields and values assigned to each asset. Default: false."
    },
    "moderations": {
      "type": "boolean",
      "description": "Whether to include image moderation status of each asset. Default: false."
    }
  },
  "required": [
    "PCID",
    "external_ids"
  ]
}

cloudinary_assets_list_resources_by_moderation_kind_and_status

Get resources by moderation kind and status Parameters:

Parameter	Type	Required	Default	Description
`resource_type`	string	Yes	—	The type of resource.
`moderation_kind`	string	Yes	—	Moderation Kind
`moderation_status`	string	Yes	—	Moderation Status
`fields`	string[]	No	—	A comma-separated list of fields to include in the response. The following fields are always included in the response: public_id, and asset_id.
`next_cursor`	string	No	—	Cursor for pagination.
`max_results`	integer	No	—	Maximum number of results to return (1-500).
`direction`	string	No	—	Sort direction.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "resource_type": {
      "type": "string",
      "description": "The type of resource.",
      "enum": [
        "image",
        "video",
        "raw"
      ]
    },
    "moderation_kind": {
      "type": "string",
      "description": "Moderation Kind",
      "enum": [
        "manual",
        "webpurify",
        "aws_rek",
        "aws_rek_video",
        "perception_point",
        "google_video_moderation",
        "duplicate"
      ]
    },
    "moderation_status": {
      "type": "string",
      "description": "Moderation Status",
      "enum": [
        "approved",
        "rejected",
        "pending",
        "queued",
        "aborted"
      ]
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "asset_folder",
          "folder",
          "filename",
          "format",
          "version",
          "version_id",
          "signature",
          "resource_type",
          "created_at",
          "uploaded_at",
          "bytes",
          "backup_bytes",
          "width",
          "height",
          "aspect_ratio",
          "access_control",
          "metadata",
          "context",
          "tags",
          "pixels",
          "custom",
          "moderation",
          "url",
          "secure_url",
          "status",
          "etag"
        ]
      },
      "description": "A comma-separated list of fields to include in the response. The following fields are always included in the response: public_id, and asset_id."
    },
    "next_cursor": {
      "type": "string",
      "description": "Cursor for pagination."
    },
    "max_results": {
      "type": "integer",
      "description": "Maximum number of results to return (1-500)."
    },
    "direction": {
      "type": "string",
      "description": "Sort direction.",
      "enum": [
        "asc",
        "desc"
      ]
    }
  },
  "required": [
    "PCID",
    "resource_type",
    "moderation_kind",
    "moderation_status"
  ]
}

cloudinary_assets_list_videos

Get video assets Parameters:

Parameter	Type	Required	Default	Description
`type`	string	No	—	The storage type of the assets. Necessary for prefix filtering.
`prefix`	string	No	—	A public_id prefix. When specified, all assets with that prefix are returned. When using this, the `type` parameter must also be specified.
`public_ids`	string[]	No	—	An array of public IDs to return.
`tags`	boolean	No	—	Whether to include the list of tag names assigned to each asset. Default: false
`next_cursor`	string	No	—	Cursor for pagination.
`max_results`	integer	No	—	Maximum number of results to return (1-500).
`direction`	string	No	—	Sort direction.
`start_at`	string	No	—	An ISO-8601 formatted timestamp. When specified, assets created since that timestamp are returned. Supported only if neither `prefix` nor `public_ids` were passed.
`fields`	string[]	No	—	A comma-separated list of fields to include in the response. The following fields are always included in the response: public_id, and asset_id.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "type": {
      "type": "string",
      "description": "The storage type of the assets. Necessary for prefix filtering.",
      "enum": [
        "upload",
        "private",
        "authenticated",
        "fetch",
        "list"
      ]
    },
    "prefix": {
      "type": "string",
      "description": "A public_id prefix. When specified, all assets with that prefix are returned. When using this, the `type` parameter must also be specified."
    },
    "public_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "An array of public IDs to return."
    },
    "tags": {
      "type": "boolean",
      "description": "Whether to include the list of tag names assigned to each asset. Default: false"
    },
    "next_cursor": {
      "type": "string",
      "description": "Cursor for pagination."
    },
    "max_results": {
      "type": "integer",
      "description": "Maximum number of results to return (1-500)."
    },
    "direction": {
      "type": "string",
      "description": "Sort direction.",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "start_at": {
      "type": "string",
      "description": "An ISO-8601 formatted timestamp. When specified, assets created since that timestamp are returned.  Supported only if neither `prefix` nor `public_ids` were passed."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "asset_folder",
          "folder",
          "filename",
          "format",
          "version",
          "version_id",
          "signature",
          "resource_type",
          "created_at",
          "uploaded_at",
          "bytes",
          "backup_bytes",
          "width",
          "height",
          "aspect_ratio",
          "access_control",
          "metadata",
          "context",
          "tags",
          "pixels",
          "custom",
          "moderation",
          "url",
          "secure_url",
          "status",
          "etag"
        ]
      },
      "description": "A comma-separated list of fields to include in the response. The following fields are always included in the response: public_id, and asset_id."
    }
  },
  "required": [
    "PCID"
  ]
}

cloudinary_assets_rename_asset

Updates an existing asset’s identifier (public ID) and optionally other metadata in your Cloudinary account Parameters:

Parameter	Type	Required	Default	Description
`resource_type`	string	Yes	—	The type of resource.
`api_key`	string	No	—	The API key to use for the request. This is automatically computed by the Cloudinary’s SDKs.
`context`	string	No	—	Context metadata to update during rename.
`from_public_id`	string	Yes	—	The public ID of the asset to rename.
`invalidate`	boolean	No	—	Whether to invalidate the CDN cache for the renamed asset.
`metadata`	string	No	—	Structured metadata to update during rename.
`notification_url`	string	No	—	URL to notify when the operation is complete.
`overwrite`	boolean	No	—	Whether to overwrite the target asset if it already exists.
`signature`	string	No	—	(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters.
`timestamp`	integer	No	—	The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary’s SDKs.
`to_public_id`	string	Yes	—	The new public ID for the asset.
`to_type`	string	No	—	The storage type of the resource.
`type`	string	No	—	The storage type of the resource.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "resource_type": {
      "type": "string",
      "description": "The type of resource.",
      "enum": [
        "image",
        "video",
        "raw"
      ]
    },
    "api_key": {
      "type": "string",
      "description": "The API key to use for the request. This is automatically computed by the Cloudinary's SDKs."
    },
    "context": {
      "type": "string",
      "description": "Context metadata to update during rename."
    },
    "from_public_id": {
      "type": "string",
      "description": "The public ID of the asset to rename."
    },
    "invalidate": {
      "type": "boolean",
      "description": "Whether to invalidate the CDN cache for the renamed asset."
    },
    "metadata": {
      "type": "string",
      "description": "Structured metadata to update during rename."
    },
    "notification_url": {
      "type": "string",
      "description": "URL to notify when the operation is complete."
    },
    "overwrite": {
      "type": "boolean",
      "description": "Whether to overwrite the target asset if it already exists."
    },
    "signature": {
      "type": "string",
      "description": "(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters."
    },
    "timestamp": {
      "type": "integer",
      "description": "The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs."
    },
    "to_public_id": {
      "type": "string",
      "description": "The new public ID for the asset."
    },
    "to_type": {
      "type": "string",
      "description": "The storage type of the resource.",
      "enum": [
        "upload",
        "private",
        "authenticated"
      ]
    },
    "type": {
      "type": "string",
      "description": "The storage type of the resource.",
      "enum": [
        "upload",
        "private",
        "authenticated"
      ]
    }
  },
  "required": [
    "PCID",
    "resource_type",
    "from_public_id",
    "to_public_id"
  ]
}

cloudinary_assets_restore_resources_by_asset_ids

Restore assets by asset ID Parameters:

Parameter	Type	Required	Default	Description
`asset_ids`	string[]	Yes	—	The unique and immutable asset IDs of backed up assets to restore.
`notification_url`	string	No	—	The URL that will receive notification when restore is complete.
`versions`	string[]	No	—	If you specify versions, the number of versions in the array must exactly match the number of asset_ids.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The unique and immutable asset IDs of backed up assets to restore."
    },
    "notification_url": {
      "type": "string",
      "description": "The URL that will receive notification when restore is complete."
    },
    "versions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "If you specify versions, the number of versions in the array must exactly match the number of asset_ids."
    }
  },
  "required": [
    "PCID",
    "asset_ids"
  ]
}

cloudinary_assets_text

Create image from text Parameters:

Parameter	Type	Required	Default	Description
`resource_type`	string	Yes	—	The type of resource to create. Must be “image” for text generation.
`background`	string	No	—	Name or RGB representation of the background color (e.g., red or
`font_color`	string	No	—	Name or RGB representation of the font’s color (e.g., red or
`font_family`	string	No	—	The name of the font family.
`font_size`	integer	No	—	Font size in points.
`font_style`	string	No	—	Whether to use a normal or italic font.
`font_weight`	string	No	—	Whether to use a normal or bold font.
`line_spacing`	integer	No	—	The spacing between lines of text in pixels.
`opacity`	integer	No	—	Text opacity value between 0 (invisible) and 100.
`public_id`	string	No	—	The identifier that is used for accessing the generated image. If not specified, a unique identifier is generated.
`text`	string	Yes	—	The text string to generate an image for.
`text_align`	string	No	—	Text alignment (left, center, right, justify).
`text_decoration`	string	No	—	Text decoration style.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "resource_type": {
      "type": "string",
      "description": "The type of resource to create. Must be \"image\" for text generation.",
      "enum": [
        "image"
      ]
    },
    "background": {
      "type": "string",
      "description": "Name or RGB representation of the background color (e.g., red or"
    },
    "font_color": {
      "type": "string",
      "description": "Name or RGB representation of the font's color (e.g., red or"
    },
    "font_family": {
      "type": "string",
      "description": "The name of the font family."
    },
    "font_size": {
      "type": "integer",
      "description": "Font size in points."
    },
    "font_style": {
      "type": "string",
      "description": "Whether to use a normal or italic font.",
      "enum": [
        "normal",
        "italic"
      ]
    },
    "font_weight": {
      "type": "string",
      "description": "Whether to use a normal or bold font.",
      "enum": [
        "normal",
        "bold"
      ]
    },
    "line_spacing": {
      "type": "integer",
      "description": "The spacing between lines of text in pixels."
    },
    "opacity": {
      "type": "integer",
      "description": "Text opacity value between 0 (invisible) and 100."
    },
    "public_id": {
      "type": "string",
      "description": "The identifier that is used for accessing the generated image. If not specified, a unique identifier is generated."
    },
    "text": {
      "type": "string",
      "description": "The text string to generate an image for."
    },
    "text_align": {
      "type": "string",
      "description": "Text alignment (left, center, right, justify).",
      "enum": [
        "left",
        "center",
        "right",
        "justify"
      ]
    },
    "text_decoration": {
      "type": "string",
      "description": "Text decoration style.",
      "enum": [
        "none",
        "underline"
      ]
    }
  },
  "required": [
    "PCID",
    "resource_type",
    "text"
  ]
}

cloudinary_assets_update_resource_by_asset_id

Updates an existing asset’s metadata, tags, and other attributes using its asset ID Parameters:

Parameter	Type	Required	Default	Description
`asset_id`	string	Yes	—	The asset ID of the resource. Must be a 32-character hexadecimal string.
`access_control`	object[]	No	—	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.
`asset_folder`	string	No	—	The folder where the asset should be placed.
`auto_tagging`	number	No	—	Confidence threshold for auto-tagging.
`background_removal`	string	No	—	The background removal provider to use for the resource. Optionally append a template suffix (e.g., cloudinary_ai:fine_edges).
`categorization`	string	No	—	The type of categorization to perform on the resource. Optionally append a language code suffix (e.g., google_tagging:fr).
`clear_invalid`	boolean	No	—	Whether to clear invalid metadata fields. If false, invalid fields will be preserved. Default: false
`context`	string	No	—	A pipe-separated list of key-value pairs of contextual metadata.
`custom_coordinates`	string	No	—	Custom coordinates as comma-separated values, with multiple coordinates separated by pipes.
`detection`	string	No	—	The type of detection to perform on the resource.
`display_name`	string	No	—	The display name of the resource.
`face_coordinates`	string	No	—	Face coordinates as comma-separated values, with multiple faces separated by pipes.
`metadata`	string	No	—	A pipe-separated list of custom metadata fields (by external_id) and their values.
`moderation_status`	string	No	—	The moderation status of the resource.
`ocr`	string	No	—	The type of OCR to perform on the resource. Set to adv_ocr, optionally with options (e.g., adv_ocr:document).
`quality_override`	string	No	—	Quality override value that will override any automatic quality transformations.
`raw_convert`	string	No	—	The conversion to apply for raw files (e.g., aspose, google_speech, extract_text).
`regions`	string	No	—	Named groups of coordinate pairs representing regions.
`tags`	string	No	—	A comma-separated list of tags to assign to the resource.
`unique_display_name`	boolean	No	—	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
`visual_search`	boolean	No	—	Whether to index the resource with visual search. If true, the resource will be indexed for visual search capabilities. Default: false

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_id": {
      "type": "string",
      "description": "The asset ID of the resource. Must be a 32-character hexadecimal string."
    },
    "access_control": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "access_type": {
            "type": "string",
            "enum": [
              "token",
              "anonymous"
            ],
            "description": "The type of access control to apply to the asset."
          },
          "key": {
            "type": "string",
            "description": "The authentication key identifier for token-based access. Default key is used if not specified or if set to 'default'."
          },
          "start": {
            "type": "string",
            "description": "The start date and time when anonymous access becomes available (ISO 8601 format)."
          },
          "end": {
            "type": "string",
            "description": "The end date and time when anonymous access expires (ISO 8601 format)."
          }
        },
        "required": [
          "access_type"
        ]
      },
      "description": "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."
    },
    "asset_folder": {
      "type": "string",
      "description": "The folder where the asset should be placed."
    },
    "auto_tagging": {
      "type": "number",
      "description": "Confidence threshold for auto-tagging."
    },
    "background_removal": {
      "type": "string",
      "description": "The background removal provider to use for the resource. Optionally append a template suffix (e.g., cloudinary_ai:fine_edges)."
    },
    "categorization": {
      "type": "string",
      "description": "The type of categorization to perform on the resource. Optionally append a language code suffix (e.g., google_tagging:fr)."
    },
    "clear_invalid": {
      "type": "boolean",
      "description": "Whether to clear invalid metadata fields. If false, invalid fields will be preserved. Default: false"
    },
    "context": {
      "type": "string",
      "description": "A pipe-separated list of key-value pairs of contextual metadata."
    },
    "custom_coordinates": {
      "type": "string",
      "description": "Custom coordinates as comma-separated values, with multiple coordinates separated by pipes."
    },
    "detection": {
      "type": "string",
      "description": "The type of detection to perform on the resource."
    },
    "display_name": {
      "type": "string",
      "description": "The display name of the resource."
    },
    "face_coordinates": {
      "type": "string",
      "description": "Face coordinates as comma-separated values, with multiple faces separated by pipes."
    },
    "metadata": {
      "type": "string",
      "description": "A pipe-separated list of custom metadata fields (by external_id) and their values."
    },
    "moderation_status": {
      "type": "string",
      "description": "The moderation status of the resource.",
      "enum": [
        "approved",
        "rejected"
      ]
    },
    "ocr": {
      "type": "string",
      "description": "The type of OCR to perform on the resource. Set to adv_ocr, optionally with options (e.g., adv_ocr:document)."
    },
    "quality_override": {
      "type": "string",
      "description": "Quality override value that will override any automatic quality transformations."
    },
    "raw_convert": {
      "type": "string",
      "description": "The conversion to apply for raw files (e.g., aspose, google_speech, extract_text)."
    },
    "regions": {
      "type": "string",
      "description": "Named groups of coordinate pairs representing regions."
    },
    "tags": {
      "type": "string",
      "description": "A comma-separated list of tags to assign to the resource."
    },
    "unique_display_name": {
      "type": "boolean",
      "description": "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"
    },
    "visual_search": {
      "type": "boolean",
      "description": "Whether to index the resource with visual search. If true, the resource will be indexed for visual search capabilities. Default: false"
    }
  },
  "required": [
    "PCID",
    "asset_id"
  ]
}

cloudinary_assets_update_resource_by_public_id

Update asset by public ID Parameters:

Parameter	Type	Required	Default	Description
`resource_type`	string	Yes	—	The type of resource.
`type`	string	Yes	—	The extended storage type of the resource.
`public_id`	string	Yes	—	The public ID of the asset.
`access_control`	object[]	No	—	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.
`asset_folder`	string	No	—	The folder where the asset should be placed.
`auto_tagging`	number	No	—	Confidence threshold for auto-tagging.
`background_removal`	string	No	—	The background removal provider to use for the resource. Optionally append a template suffix (e.g., cloudinary_ai:fine_edges).
`categorization`	string	No	—	The type of categorization to perform on the resource. Optionally append a language code suffix (e.g., google_tagging:fr).
`clear_invalid`	boolean	No	—	Whether to clear invalid metadata fields. If false, invalid fields will be preserved. Default: false
`context`	string	No	—	A pipe-separated list of key-value pairs of contextual metadata.
`custom_coordinates`	string	No	—	Custom coordinates as comma-separated values, with multiple coordinates separated by pipes.
`detection`	string	No	—	The type of detection to perform on the resource.
`display_name`	string	No	—	The display name of the resource.
`face_coordinates`	string	No	—	Face coordinates as comma-separated values, with multiple faces separated by pipes.
`metadata`	string	No	—	A pipe-separated list of custom metadata fields (by external_id) and their values.
`moderation_status`	string	No	—	The moderation status of the resource.
`ocr`	string	No	—	The type of OCR to perform on the resource. Set to adv_ocr, optionally with options (e.g., adv_ocr:document).
`quality_override`	string	No	—	Quality override value that will override any automatic quality transformations.
`raw_convert`	string	No	—	The conversion to apply for raw files (e.g., aspose, google_speech, extract_text).
`regions`	string	No	—	Named groups of coordinate pairs representing regions.
`tags`	string	No	—	A comma-separated list of tags to assign to the resource.
`unique_display_name`	boolean	No	—	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
`visual_search`	boolean	No	—	Whether to index the resource with visual search. If true, the resource will be indexed for visual search capabilities. Default: false

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "resource_type": {
      "type": "string",
      "description": "The type of resource.",
      "enum": [
        "image",
        "video",
        "raw"
      ]
    },
    "type": {
      "type": "string",
      "description": "The extended storage type of the resource.",
      "enum": [
        "upload",
        "private",
        "authenticated",
        "fetch",
        "list",
        "facebook",
        "twitter",
        "gravatar",
        "youtube",
        "hulu",
        "vimeo",
        "animoto",
        "worldstarhiphop",
        "dailymotion"
      ]
    },
    "public_id": {
      "type": "string",
      "description": "The public ID of the asset."
    },
    "access_control": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "access_type": {
            "type": "string",
            "enum": [
              "token",
              "anonymous"
            ],
            "description": "The type of access control to apply to the asset."
          },
          "key": {
            "type": "string",
            "description": "The authentication key identifier for token-based access. Default key is used if not specified or if set to 'default'."
          },
          "start": {
            "type": "string",
            "description": "The start date and time when anonymous access becomes available (ISO 8601 format)."
          },
          "end": {
            "type": "string",
            "description": "The end date and time when anonymous access expires (ISO 8601 format)."
          }
        },
        "required": [
          "access_type"
        ]
      },
      "description": "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."
    },
    "asset_folder": {
      "type": "string",
      "description": "The folder where the asset should be placed."
    },
    "auto_tagging": {
      "type": "number",
      "description": "Confidence threshold for auto-tagging."
    },
    "background_removal": {
      "type": "string",
      "description": "The background removal provider to use for the resource. Optionally append a template suffix (e.g., cloudinary_ai:fine_edges)."
    },
    "categorization": {
      "type": "string",
      "description": "The type of categorization to perform on the resource. Optionally append a language code suffix (e.g., google_tagging:fr)."
    },
    "clear_invalid": {
      "type": "boolean",
      "description": "Whether to clear invalid metadata fields. If false, invalid fields will be preserved. Default: false"
    },
    "context": {
      "type": "string",
      "description": "A pipe-separated list of key-value pairs of contextual metadata."
    },
    "custom_coordinates": {
      "type": "string",
      "description": "Custom coordinates as comma-separated values, with multiple coordinates separated by pipes."
    },
    "detection": {
      "type": "string",
      "description": "The type of detection to perform on the resource."
    },
    "display_name": {
      "type": "string",
      "description": "The display name of the resource."
    },
    "face_coordinates": {
      "type": "string",
      "description": "Face coordinates as comma-separated values, with multiple faces separated by pipes."
    },
    "metadata": {
      "type": "string",
      "description": "A pipe-separated list of custom metadata fields (by external_id) and their values."
    },
    "moderation_status": {
      "type": "string",
      "description": "The moderation status of the resource.",
      "enum": [
        "approved",
        "rejected"
      ]
    },
    "ocr": {
      "type": "string",
      "description": "The type of OCR to perform on the resource. Set to adv_ocr, optionally with options (e.g., adv_ocr:document)."
    },
    "quality_override": {
      "type": "string",
      "description": "Quality override value that will override any automatic quality transformations."
    },
    "raw_convert": {
      "type": "string",
      "description": "The conversion to apply for raw files (e.g., aspose, google_speech, extract_text)."
    },
    "regions": {
      "type": "string",
      "description": "Named groups of coordinate pairs representing regions."
    },
    "tags": {
      "type": "string",
      "description": "A comma-separated list of tags to assign to the resource."
    },
    "unique_display_name": {
      "type": "boolean",
      "description": "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"
    },
    "visual_search": {
      "type": "boolean",
      "description": "Whether to index the resource with visual search. If true, the resource will be indexed for visual search capabilities. Default: false"
    }
  },
  "required": [
    "PCID",
    "resource_type",
    "type",
    "public_id"
  ]
}

cloudinary_assets_upload

Uploads media assets (images, videos, raw files) to your Cloudinary product environment Parameters:

Parameter	Type	Required	Default	Description
`resource_type`	string	Yes	—	The type of resource to upload: - “image” for uploading strictly images - “video” for uploading strictly videos - “raw” for uploading non-media files - “auto” for allowing Cloudinary to automatically detect the type of the uploaded file
`access_control`	object[]	No	—	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.
`access_mode`	string	No	—	Allows the asset to behave as if it’s of the authenticated ‘type’ (see above) 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. Valid values: public, and authenticated.
`accessibility_analysis`	boolean	No	—	Whether to return return accessibility analysis values for the image.
`allowed_formats`	string	No	—	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 wont be converted.
`api_key`	string	No	—	The API key to use for the request. This is automatically computed by the Cloudinary’s SDKs.
`asset_folder`	string	No	—	The asset folder to assign to the asset.
`async`	boolean	No	—	When set to true, returns the uploaded asset’s public_id immediately in the response, before the upload is completed (asynchronously). Default: false.
`auto_chaptering`	boolean	No	—	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.
`auto_tagging`	number	No	—	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: - Cloudinary AI Content Analysis - Amazon Rekognition Celebrity Detection Use together with the categorization parameter for: - Google Automatic Video Tagging - Google Auto Tagging - Imagga Auto Tagging - Amazon Rekognition Auto Tagging
`auto_transcription`	object	No	—	Auto Transcription
`background_removal`	string	No	—	Automatically remove the background of an image using an add-on. - Set to cloudinary_ai to use the deep-learning based Cloudinary AI Background Removal add-on. Optionally append a template suffix (e.g., cloudinary_ai:fine_edges). - 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. Relevant for images only.
`backup`	boolean	No	—	Whether to backup the uploaded asset. When set to true, backs up uploaded assets to a secondary storage bucket.
`callback`	string	No	—	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.
`categorization`	string	No	—	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).
`cinemagraph_analysis`	boolean	No	—	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.
`colors`	boolean	No	—	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.
`context`	string	No	—	Key-value pairs of general textual context metadata to attach to the asset.
`custom_coordinates`	string	No	—	An array of coordinates for custom cropping.
`detection`	string	No	—	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.
`discard_original_filename`	boolean	No	—	Whether to discard the name of the original uploaded file. Relevant when delivering assets as attachments (setting the flag disposition:attachment in delivery URLs).
`display_name`	string	No	—	A display name for the asset.
`eager`	string	No	—	A list of transformations to eagerly generate for the asset. Accepts either a single transformation or a pipe-separated list of transformations.
`eager_async`	boolean	No	—	Whether to generate the eager transformations asynchronously in the background after the upload request is completed rather than before the upload is completed.
`eager_notification_url`	string	No	—	A URL to notify when eager transformations are completed.
`evalScript`	string	No	—	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`	string	No	—	An array of coordinates representing detected faces in the asset, used for custom cropping or overlays.
`faces`	boolean	No	—	Whether to detect faces in the asset.
`file`	string	Yes	—	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://.
`filename_override`	string	No	—	Overrides the originally uploaded asset’s file name in downloads that use flags like fl_attachment or fl_force_original.
`folder`	string	No	—	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.
`format`	string	No	—	An optional format to convert the uploaded asset to before saving in the cloud.
`headers`	string	No	—	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.
`invalidate`	boolean	No	—	Whether to invalidate CDN cache copies of a previously uploaded asset that shares the same public ID. Default: false.
`media_metadata`	boolean	No	—	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.
`metadata`	string	No	—	Structured metadata to attach to the asset based on the metadata fields defined for your account.
`moderation`	string	No	—	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.
`notification_url`	string	No	—	A URL to notify when the asset is ready.
`ocr`	string	No	—	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).
`on_success`	string	No	—	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.
`overwrite`	boolean	No	—	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).
`phash`	boolean	No	—	Whether to return the perceptual hash (pHash) on the uploaded image for image similarity detection.
`proxy`	string	No	—	A proxy to use for fetching remote URLs. The format should be `http://hostname:port.`
`public_id`	string	No	—	The identifier that is used for accessing the uploaded asset. If not specified, a unique ID is generated automatically.
`public_id_prefix`	string	No	—	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.
`quality_analysis`	boolean	No	—	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.
`raw_convert`	string	No	—	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)
`regions`	string	No	—	Regions to detect in the asset.
`responsive_breakpoints`	object[]	No	—	Settings to automatically generate breakpoints for responsive images.
`return_delete_token`	boolean	No	—	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.
`signature`	string	No	—	(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters.
`tags`	string	No	—	A comma-separated list of tag names to assign to the asset.
`timestamp`	integer	No	—	The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary’s SDKs.
`transformation`	string	No	—	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.
`type`	string	No	—	The delivery type that defines if and how the uploaded asset is available for public delivery. By default, all uploaded assets are public (upload). Possible values are upload, authenticated, private or asset.
`unique_display_name`	boolean	No	—	Whether the display name should be unique.
`unique_filename`	boolean	No	—	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).
`upload_preset`	string	No	—	(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.
`use_asset_folder_as_public_id_prefix`	boolean	No	—	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.
`use_filename`	boolean	No	—	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.
`use_filename_as_display_name`	boolean	No	—	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.
`visual_search`	boolean	No	—	Whether to index the image for use with visual searches. Relevant for images only.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "resource_type": {
      "type": "string",
      "description": "The type of resource to upload: - \"image\" for uploading strictly images - \"video\" for uploading strictly videos - \"raw\" for uploading non-media files - \"auto\" for allowing Cloudinary to automatically detect the type of the uploaded file",
      "enum": [
        "image",
        "video",
        "raw",
        "auto"
      ]
    },
    "access_control": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "access_type": {
            "type": "string",
            "enum": [
              "token",
              "anonymous"
            ],
            "description": "The type of access control to apply to the asset."
          },
          "key": {
            "type": "string",
            "description": "The authentication key identifier for token-based access. Default key is used if not specified or if set to 'default'."
          },
          "start": {
            "type": "string",
            "description": "The start date and time when anonymous access becomes available (ISO 8601 format)."
          },
          "end": {
            "type": "string",
            "description": "The end date and time when anonymous access expires (ISO 8601 format)."
          }
        },
        "required": [
          "access_type"
        ]
      },
      "description": "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."
    },
    "access_mode": {
      "type": "string",
      "description": "Allows the asset to behave as if it's of the authenticated 'type' (see above) 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. Valid values: public, and authenticated.",
      "enum": [
        "public",
        "authenticated"
      ]
    },
    "accessibility_analysis": {
      "type": "boolean",
      "description": "Whether to return return accessibility analysis values for the image."
    },
    "allowed_formats": {
      "type": "string",
      "description": "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 wont be converted."
    },
    "api_key": {
      "type": "string",
      "description": "The API key to use for the request. This is automatically computed by the Cloudinary's SDKs."
    },
    "asset_folder": {
      "type": "string",
      "description": "The asset folder to assign to the asset."
    },
    "async": {
      "type": "boolean",
      "description": "When set to true, returns the uploaded asset's public_id immediately in the response, before the upload is completed (asynchronously). Default: false."
    },
    "auto_chaptering": {
      "type": "boolean",
      "description": "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."
    },
    "auto_tagging": {
      "type": "number",
      "description": "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: - Cloudinary AI Content Analysis - Amazon Rekognition Celebrity Detection Use together with the categorization parameter for: - Google Automatic Video Tagging - Google Auto Tagging - Imagga Auto Tagging - Amazon Rekognition Auto Tagging"
    },
    "auto_transcription": {
      "description": "Auto Transcription"
    },
    "background_removal": {
      "type": "string",
      "description": "Automatically remove the background of an image using an add-on. - Set to cloudinary_ai to use the deep-learning based Cloudinary AI Background Removal add-on.   Optionally append a template suffix (e.g., cloudinary_ai:fine_edges). - 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. Relevant for images only."
    },
    "backup": {
      "type": "boolean",
      "description": "Whether to backup the uploaded asset. When set to true, backs up uploaded assets to a secondary storage bucket."
    },
    "callback": {
      "type": "string",
      "description": "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."
    },
    "categorization": {
      "type": "string",
      "description": "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)."
    },
    "cinemagraph_analysis": {
      "type": "boolean",
      "description": "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."
    },
    "colors": {
      "type": "boolean",
      "description": "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."
    },
    "context": {
      "type": "string",
      "description": "Key-value pairs of general textual context metadata to attach to the asset."
    },
    "custom_coordinates": {
      "type": "string",
      "description": "An array of coordinates for custom cropping."
    },
    "detection": {
      "type": "string",
      "description": "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."
    },
    "discard_original_filename": {
      "type": "boolean",
      "description": "Whether to discard the name of the original uploaded file. Relevant when delivering assets as attachments (setting the flag disposition:attachment in delivery URLs)."
    },
    "display_name": {
      "type": "string",
      "description": "A display name for the asset."
    },
    "eager": {
      "type": "string",
      "description": "A list of transformations to eagerly generate for the asset. Accepts either a single transformation or a pipe-separated list of transformations."
    },
    "eager_async": {
      "type": "boolean",
      "description": "Whether to generate the eager transformations asynchronously in the background after the upload request is completed rather than before the upload is completed."
    },
    "eager_notification_url": {
      "type": "string",
      "description": "A URL to notify when eager transformations are completed."
    },
    "evalScript": {
      "type": "string",
      "description": "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": {
      "type": "string",
      "description": "An array of coordinates representing detected faces in the asset, used for custom cropping or overlays."
    },
    "faces": {
      "type": "boolean",
      "description": "Whether to detect faces in the asset."
    },
    "file": {
      "type": "string",
      "description": "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://."
    },
    "filename_override": {
      "type": "string",
      "description": "Overrides the originally uploaded asset's file name in downloads that use flags like fl_attachment or fl_force_original."
    },
    "folder": {
      "type": "string",
      "description": "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."
    },
    "format": {
      "type": "string",
      "description": "An optional format to convert the uploaded asset to before saving in the cloud."
    },
    "headers": {
      "type": "string",
      "description": "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."
    },
    "invalidate": {
      "type": "boolean",
      "description": "Whether to invalidate CDN cache copies of a previously uploaded asset that shares the same public ID. Default: false."
    },
    "media_metadata": {
      "type": "boolean",
      "description": "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."
    },
    "metadata": {
      "type": "string",
      "description": "Structured metadata to attach to the asset based on the metadata fields defined for your account."
    },
    "moderation": {
      "type": "string",
      "description": "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."
    },
    "notification_url": {
      "type": "string",
      "description": "A URL to notify when the asset is ready."
    },
    "ocr": {
      "type": "string",
      "description": "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)."
    },
    "on_success": {
      "type": "string",
      "description": "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."
    },
    "overwrite": {
      "type": "boolean",
      "description": "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)."
    },
    "phash": {
      "type": "boolean",
      "description": "Whether to return the perceptual hash (pHash) on the uploaded image for image similarity detection."
    },
    "proxy": {
      "type": "string",
      "description": "A proxy to use for fetching remote URLs. The format should be http://hostname:port."
    },
    "public_id": {
      "type": "string",
      "description": "The identifier that is used for accessing the uploaded asset. If not specified, a unique ID is generated automatically."
    },
    "public_id_prefix": {
      "type": "string",
      "description": "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."
    },
    "quality_analysis": {
      "type": "boolean",
      "description": "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."
    },
    "raw_convert": {
      "type": "string",
      "description": "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)"
    },
    "regions": {
      "type": "string",
      "description": "Regions to detect in the asset."
    },
    "responsive_breakpoints": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "create_derived": {
            "type": "boolean",
            "description": "Create Derived"
          },
          "max_width": {
            "type": "integer",
            "description": "Max Width"
          },
          "min_width": {
            "type": "integer",
            "description": "Min Width"
          },
          "bytes_step": {
            "type": "integer",
            "description": "Bytes Step"
          },
          "max_images": {
            "type": "integer",
            "description": "Max Images"
          },
          "transformation": {
            "type": "string",
            "description": "The transformation value"
          }
        }
      },
      "description": "Settings to automatically generate breakpoints for responsive images."
    },
    "return_delete_token": {
      "type": "boolean",
      "description": "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."
    },
    "signature": {
      "type": "string",
      "description": "(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters."
    },
    "tags": {
      "type": "string",
      "description": "A comma-separated list of tag names to assign to the asset."
    },
    "timestamp": {
      "type": "integer",
      "description": "The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs."
    },
    "transformation": {
      "type": "string",
      "description": "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."
    },
    "type": {
      "type": "string",
      "description": "The delivery type that defines if and how the uploaded asset is available for public delivery. By default, all uploaded assets are public (upload). Possible values are upload, authenticated, private or asset.",
      "enum": [
        "upload",
        "authenticated",
        "private",
        "asset"
      ]
    },
    "unique_display_name": {
      "type": "boolean",
      "description": "Whether the display name should be unique."
    },
    "unique_filename": {
      "type": "boolean",
      "description": "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)."
    },
    "upload_preset": {
      "type": "string",
      "description": "(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."
    },
    "use_asset_folder_as_public_id_prefix": {
      "type": "boolean",
      "description": "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."
    },
    "use_filename": {
      "type": "boolean",
      "description": "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."
    },
    "use_filename_as_display_name": {
      "type": "boolean",
      "description": "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."
    },
    "visual_search": {
      "type": "boolean",
      "description": "Whether to index the image for use with visual searches. Relevant for images only."
    }
  },
  "required": [
    "PCID",
    "resource_type",
    "file"
  ]
}

cloudinary_assets_upload_chunk

Upload a single chunk of a large file Parameters:

Parameter	Type	Required	Default	Description
`resource_type`	string	Yes	—	The type of resource to upload: - “image” for uploading strictly images - “video” for uploading strictly videos - “raw” for uploading non-media files - “auto” for allowing Cloudinary to automatically detect the type of the uploaded file
`Content-Range`	string	Yes	—	The range of bytes being uploaded in the current chunk, in the format “bytes start-end/total”. For example, “bytes 0-999999/3000000” indicates the first 1MB chunk of a 3MB file.
`X-Unique-Upload-Id`	string	Yes	—	A unique identifier for the upload. Must be the same for all chunks of the same file.
`access_control`	object[]	No	—	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.
`access_mode`	string	No	—	Allows the asset to behave as if it’s of the authenticated ‘type’ (see above) 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. Valid values: public, and authenticated.
`accessibility_analysis`	boolean	No	—	Whether to return return accessibility analysis values for the image.
`allowed_formats`	string	No	—	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 wont be converted.
`api_key`	string	No	—	The API key to use for the request. This is automatically computed by the Cloudinary’s SDKs.
`asset_folder`	string	No	—	The asset folder to assign to the asset.
`async`	boolean	No	—	When set to true, returns the uploaded asset’s public_id immediately in the response, before the upload is completed (asynchronously). Default: false.
`auto_chaptering`	boolean	No	—	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.
`auto_tagging`	number	No	—	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: - Cloudinary AI Content Analysis - Amazon Rekognition Celebrity Detection Use together with the categorization parameter for: - Google Automatic Video Tagging - Google Auto Tagging - Imagga Auto Tagging - Amazon Rekognition Auto Tagging
`auto_transcription`	object	No	—	Auto Transcription
`background_removal`	string	No	—	Automatically remove the background of an image using an add-on. - Set to cloudinary_ai to use the deep-learning based Cloudinary AI Background Removal add-on. Optionally append a template suffix (e.g., cloudinary_ai:fine_edges). - 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. Relevant for images only.
`backup`	boolean	No	—	Whether to backup the uploaded asset. When set to true, backs up uploaded assets to a secondary storage bucket.
`callback`	string	No	—	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.
`categorization`	string	No	—	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).
`cinemagraph_analysis`	boolean	No	—	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.
`colors`	boolean	No	—	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.
`context`	string	No	—	Key-value pairs of general textual context metadata to attach to the asset.
`custom_coordinates`	string	No	—	An array of coordinates for custom cropping.
`detection`	string	No	—	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.
`discard_original_filename`	boolean	No	—	Whether to discard the name of the original uploaded file. Relevant when delivering assets as attachments (setting the flag disposition:attachment in delivery URLs).
`display_name`	string	No	—	A display name for the asset.
`eager`	string	No	—	A list of transformations to eagerly generate for the asset. Accepts either a single transformation or a pipe-separated list of transformations.
`eager_async`	boolean	No	—	Whether to generate the eager transformations asynchronously in the background after the upload request is completed rather than before the upload is completed.
`eager_notification_url`	string	No	—	A URL to notify when eager transformations are completed.
`evalScript`	string	No	—	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`	string	No	—	An array of coordinates representing detected faces in the asset, used for custom cropping or overlays.
`faces`	boolean	No	—	Whether to detect faces in the asset.
`file`	string	Yes	—	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://.
`filename_override`	string	No	—	Overrides the originally uploaded asset’s file name in downloads that use flags like fl_attachment or fl_force_original.
`folder`	string	No	—	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.
`format`	string	No	—	An optional format to convert the uploaded asset to before saving in the cloud.
`headers`	string	No	—	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.
`invalidate`	boolean	No	—	Whether to invalidate CDN cache copies of a previously uploaded asset that shares the same public ID. Default: false.
`media_metadata`	boolean	No	—	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.
`metadata`	string	No	—	Structured metadata to attach to the asset based on the metadata fields defined for your account.
`moderation`	string	No	—	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.
`notification_url`	string	No	—	A URL to notify when the asset is ready.
`ocr`	string	No	—	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).
`on_success`	string	No	—	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.
`overwrite`	boolean	No	—	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).
`phash`	boolean	No	—	Whether to return the perceptual hash (pHash) on the uploaded image for image similarity detection.
`proxy`	string	No	—	A proxy to use for fetching remote URLs. The format should be `http://hostname:port.`
`public_id`	string	No	—	The identifier that is used for accessing the uploaded asset. If not specified, a unique ID is generated automatically.
`public_id_prefix`	string	No	—	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.
`quality_analysis`	boolean	No	—	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.
`raw_convert`	string	No	—	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)
`regions`	string	No	—	Regions to detect in the asset.
`responsive_breakpoints`	object[]	No	—	Settings to automatically generate breakpoints for responsive images.
`return_delete_token`	boolean	No	—	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.
`signature`	string	No	—	(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters.
`tags`	string	No	—	A comma-separated list of tag names to assign to the asset.
`timestamp`	integer	No	—	The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary’s SDKs.
`transformation`	string	No	—	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.
`type`	string	No	—	The delivery type that defines if and how the uploaded asset is available for public delivery. By default, all uploaded assets are public (upload). Possible values are upload, authenticated, private or asset.
`unique_display_name`	boolean	No	—	Whether the display name should be unique.
`unique_filename`	boolean	No	—	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).
`upload_preset`	string	No	—	(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.
`use_asset_folder_as_public_id_prefix`	boolean	No	—	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.
`use_filename`	boolean	No	—	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.
`use_filename_as_display_name`	boolean	No	—	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.
`visual_search`	boolean	No	—	Whether to index the image for use with visual searches. Relevant for images only.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "resource_type": {
      "type": "string",
      "description": "The type of resource to upload: - \"image\" for uploading strictly images - \"video\" for uploading strictly videos - \"raw\" for uploading non-media files - \"auto\" for allowing Cloudinary to automatically detect the type of the uploaded file",
      "enum": [
        "image",
        "video",
        "raw",
        "auto"
      ]
    },
    "Content-Range": {
      "type": "string",
      "description": "The range of bytes being uploaded in the current chunk, in the format \"bytes start-end/total\". For example, \"bytes 0-999999/3000000\" indicates the first 1MB chunk of a 3MB file."
    },
    "X-Unique-Upload-Id": {
      "type": "string",
      "description": "A unique identifier for the upload. Must be the same for all chunks of the same file."
    },
    "access_control": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "access_type": {
            "type": "string",
            "enum": [
              "token",
              "anonymous"
            ],
            "description": "The type of access control to apply to the asset."
          },
          "key": {
            "type": "string",
            "description": "The authentication key identifier for token-based access. Default key is used if not specified or if set to 'default'."
          },
          "start": {
            "type": "string",
            "description": "The start date and time when anonymous access becomes available (ISO 8601 format)."
          },
          "end": {
            "type": "string",
            "description": "The end date and time when anonymous access expires (ISO 8601 format)."
          }
        },
        "required": [
          "access_type"
        ]
      },
      "description": "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."
    },
    "access_mode": {
      "type": "string",
      "description": "Allows the asset to behave as if it's of the authenticated 'type' (see above) 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. Valid values: public, and authenticated.",
      "enum": [
        "public",
        "authenticated"
      ]
    },
    "accessibility_analysis": {
      "type": "boolean",
      "description": "Whether to return return accessibility analysis values for the image."
    },
    "allowed_formats": {
      "type": "string",
      "description": "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 wont be converted."
    },
    "api_key": {
      "type": "string",
      "description": "The API key to use for the request. This is automatically computed by the Cloudinary's SDKs."
    },
    "asset_folder": {
      "type": "string",
      "description": "The asset folder to assign to the asset."
    },
    "async": {
      "type": "boolean",
      "description": "When set to true, returns the uploaded asset's public_id immediately in the response, before the upload is completed (asynchronously). Default: false."
    },
    "auto_chaptering": {
      "type": "boolean",
      "description": "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."
    },
    "auto_tagging": {
      "type": "number",
      "description": "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: - Cloudinary AI Content Analysis - Amazon Rekognition Celebrity Detection Use together with the categorization parameter for: - Google Automatic Video Tagging - Google Auto Tagging - Imagga Auto Tagging - Amazon Rekognition Auto Tagging"
    },
    "auto_transcription": {
      "description": "Auto Transcription"
    },
    "background_removal": {
      "type": "string",
      "description": "Automatically remove the background of an image using an add-on. - Set to cloudinary_ai to use the deep-learning based Cloudinary AI Background Removal add-on.   Optionally append a template suffix (e.g., cloudinary_ai:fine_edges). - 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. Relevant for images only."
    },
    "backup": {
      "type": "boolean",
      "description": "Whether to backup the uploaded asset. When set to true, backs up uploaded assets to a secondary storage bucket."
    },
    "callback": {
      "type": "string",
      "description": "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."
    },
    "categorization": {
      "type": "string",
      "description": "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)."
    },
    "cinemagraph_analysis": {
      "type": "boolean",
      "description": "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."
    },
    "colors": {
      "type": "boolean",
      "description": "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."
    },
    "context": {
      "type": "string",
      "description": "Key-value pairs of general textual context metadata to attach to the asset."
    },
    "custom_coordinates": {
      "type": "string",
      "description": "An array of coordinates for custom cropping."
    },
    "detection": {
      "type": "string",
      "description": "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."
    },
    "discard_original_filename": {
      "type": "boolean",
      "description": "Whether to discard the name of the original uploaded file. Relevant when delivering assets as attachments (setting the flag disposition:attachment in delivery URLs)."
    },
    "display_name": {
      "type": "string",
      "description": "A display name for the asset."
    },
    "eager": {
      "type": "string",
      "description": "A list of transformations to eagerly generate for the asset. Accepts either a single transformation or a pipe-separated list of transformations."
    },
    "eager_async": {
      "type": "boolean",
      "description": "Whether to generate the eager transformations asynchronously in the background after the upload request is completed rather than before the upload is completed."
    },
    "eager_notification_url": {
      "type": "string",
      "description": "A URL to notify when eager transformations are completed."
    },
    "evalScript": {
      "type": "string",
      "description": "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": {
      "type": "string",
      "description": "An array of coordinates representing detected faces in the asset, used for custom cropping or overlays."
    },
    "faces": {
      "type": "boolean",
      "description": "Whether to detect faces in the asset."
    },
    "file": {
      "type": "string",
      "description": "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://."
    },
    "filename_override": {
      "type": "string",
      "description": "Overrides the originally uploaded asset's file name in downloads that use flags like fl_attachment or fl_force_original."
    },
    "folder": {
      "type": "string",
      "description": "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."
    },
    "format": {
      "type": "string",
      "description": "An optional format to convert the uploaded asset to before saving in the cloud."
    },
    "headers": {
      "type": "string",
      "description": "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."
    },
    "invalidate": {
      "type": "boolean",
      "description": "Whether to invalidate CDN cache copies of a previously uploaded asset that shares the same public ID. Default: false."
    },
    "media_metadata": {
      "type": "boolean",
      "description": "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."
    },
    "metadata": {
      "type": "string",
      "description": "Structured metadata to attach to the asset based on the metadata fields defined for your account."
    },
    "moderation": {
      "type": "string",
      "description": "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."
    },
    "notification_url": {
      "type": "string",
      "description": "A URL to notify when the asset is ready."
    },
    "ocr": {
      "type": "string",
      "description": "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)."
    },
    "on_success": {
      "type": "string",
      "description": "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."
    },
    "overwrite": {
      "type": "boolean",
      "description": "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)."
    },
    "phash": {
      "type": "boolean",
      "description": "Whether to return the perceptual hash (pHash) on the uploaded image for image similarity detection."
    },
    "proxy": {
      "type": "string",
      "description": "A proxy to use for fetching remote URLs. The format should be http://hostname:port."
    },
    "public_id": {
      "type": "string",
      "description": "The identifier that is used for accessing the uploaded asset. If not specified, a unique ID is generated automatically."
    },
    "public_id_prefix": {
      "type": "string",
      "description": "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."
    },
    "quality_analysis": {
      "type": "boolean",
      "description": "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."
    },
    "raw_convert": {
      "type": "string",
      "description": "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)"
    },
    "regions": {
      "type": "string",
      "description": "Regions to detect in the asset."
    },
    "responsive_breakpoints": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "create_derived": {
            "type": "boolean",
            "description": "Create Derived"
          },
          "max_width": {
            "type": "integer",
            "description": "Max Width"
          },
          "min_width": {
            "type": "integer",
            "description": "Min Width"
          },
          "bytes_step": {
            "type": "integer",
            "description": "Bytes Step"
          },
          "max_images": {
            "type": "integer",
            "description": "Max Images"
          },
          "transformation": {
            "type": "string",
            "description": "The transformation value"
          }
        }
      },
      "description": "Settings to automatically generate breakpoints for responsive images."
    },
    "return_delete_token": {
      "type": "boolean",
      "description": "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."
    },
    "signature": {
      "type": "string",
      "description": "(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters."
    },
    "tags": {
      "type": "string",
      "description": "A comma-separated list of tag names to assign to the asset."
    },
    "timestamp": {
      "type": "integer",
      "description": "The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs."
    },
    "transformation": {
      "type": "string",
      "description": "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."
    },
    "type": {
      "type": "string",
      "description": "The delivery type that defines if and how the uploaded asset is available for public delivery. By default, all uploaded assets are public (upload). Possible values are upload, authenticated, private or asset.",
      "enum": [
        "upload",
        "authenticated",
        "private",
        "asset"
      ]
    },
    "unique_display_name": {
      "type": "boolean",
      "description": "Whether the display name should be unique."
    },
    "unique_filename": {
      "type": "boolean",
      "description": "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)."
    },
    "upload_preset": {
      "type": "string",
      "description": "(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."
    },
    "use_asset_folder_as_public_id_prefix": {
      "type": "boolean",
      "description": "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."
    },
    "use_filename": {
      "type": "boolean",
      "description": "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."
    },
    "use_filename_as_display_name": {
      "type": "boolean",
      "description": "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."
    },
    "visual_search": {
      "type": "boolean",
      "description": "Whether to index the image for use with visual searches. Relevant for images only."
    }
  },
  "required": [
    "PCID",
    "resource_type",
    "Content-Range",
    "X-Unique-Upload-Id",
    "file"
  ]
}

cloudinary_assets_upload_no_resource_type

Upload with automatic file type detection Parameters:

Parameter	Type	Required	Default	Description
`access_control`	object[]	No	—	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.
`access_mode`	string	No	—	Allows the asset to behave as if it’s of the authenticated ‘type’ (see above) 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. Valid values: public, and authenticated.
`accessibility_analysis`	boolean	No	—	Whether to return return accessibility analysis values for the image.
`allowed_formats`	string	No	—	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 wont be converted.
`api_key`	string	No	—	The API key to use for the request. This is automatically computed by the Cloudinary’s SDKs.
`asset_folder`	string	No	—	The asset folder to assign to the asset.
`async`	boolean	No	—	When set to true, returns the uploaded asset’s public_id immediately in the response, before the upload is completed (asynchronously). Default: false.
`auto_chaptering`	boolean	No	—	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.
`auto_tagging`	number	No	—	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: - Cloudinary AI Content Analysis - Amazon Rekognition Celebrity Detection Use together with the categorization parameter for: - Google Automatic Video Tagging - Google Auto Tagging - Imagga Auto Tagging - Amazon Rekognition Auto Tagging
`auto_transcription`	object	No	—	Auto Transcription
`background_removal`	string	No	—	Automatically remove the background of an image using an add-on. - Set to cloudinary_ai to use the deep-learning based Cloudinary AI Background Removal add-on. Optionally append a template suffix (e.g., cloudinary_ai:fine_edges). - 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. Relevant for images only.
`backup`	boolean	No	—	Whether to backup the uploaded asset. When set to true, backs up uploaded assets to a secondary storage bucket.
`callback`	string	No	—	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.
`categorization`	string	No	—	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).
`cinemagraph_analysis`	boolean	No	—	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.
`colors`	boolean	No	—	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.
`context`	string	No	—	Key-value pairs of general textual context metadata to attach to the asset.
`custom_coordinates`	string	No	—	An array of coordinates for custom cropping.
`detection`	string	No	—	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.
`discard_original_filename`	boolean	No	—	Whether to discard the name of the original uploaded file. Relevant when delivering assets as attachments (setting the flag disposition:attachment in delivery URLs).
`display_name`	string	No	—	A display name for the asset.
`eager`	string	No	—	A list of transformations to eagerly generate for the asset. Accepts either a single transformation or a pipe-separated list of transformations.
`eager_async`	boolean	No	—	Whether to generate the eager transformations asynchronously in the background after the upload request is completed rather than before the upload is completed.
`eager_notification_url`	string	No	—	A URL to notify when eager transformations are completed.
`evalScript`	string	No	—	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`	string	No	—	An array of coordinates representing detected faces in the asset, used for custom cropping or overlays.
`faces`	boolean	No	—	Whether to detect faces in the asset.
`file`	string	Yes	—	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://.
`filename_override`	string	No	—	Overrides the originally uploaded asset’s file name in downloads that use flags like fl_attachment or fl_force_original.
`folder`	string	No	—	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.
`format`	string	No	—	An optional format to convert the uploaded asset to before saving in the cloud.
`headers`	string	No	—	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.
`invalidate`	boolean	No	—	Whether to invalidate CDN cache copies of a previously uploaded asset that shares the same public ID. Default: false.
`media_metadata`	boolean	No	—	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.
`metadata`	string	No	—	Structured metadata to attach to the asset based on the metadata fields defined for your account.
`moderation`	string	No	—	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.
`notification_url`	string	No	—	A URL to notify when the asset is ready.
`ocr`	string	No	—	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).
`on_success`	string	No	—	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.
`overwrite`	boolean	No	—	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).
`phash`	boolean	No	—	Whether to return the perceptual hash (pHash) on the uploaded image for image similarity detection.
`proxy`	string	No	—	A proxy to use for fetching remote URLs. The format should be `http://hostname:port.`
`public_id`	string	No	—	The identifier that is used for accessing the uploaded asset. If not specified, a unique ID is generated automatically.
`public_id_prefix`	string	No	—	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.
`quality_analysis`	boolean	No	—	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.
`raw_convert`	string	No	—	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)
`regions`	string	No	—	Regions to detect in the asset.
`responsive_breakpoints`	object[]	No	—	Settings to automatically generate breakpoints for responsive images.
`return_delete_token`	boolean	No	—	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.
`signature`	string	No	—	(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters.
`tags`	string	No	—	A comma-separated list of tag names to assign to the asset.
`timestamp`	integer	No	—	The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary’s SDKs.
`transformation`	string	No	—	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.
`type`	string	No	—	The delivery type that defines if and how the uploaded asset is available for public delivery. By default, all uploaded assets are public (upload). Possible values are upload, authenticated, private or asset.
`unique_display_name`	boolean	No	—	Whether the display name should be unique.
`unique_filename`	boolean	No	—	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).
`upload_preset`	string	No	—	(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.
`use_asset_folder_as_public_id_prefix`	boolean	No	—	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.
`use_filename`	boolean	No	—	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.
`use_filename_as_display_name`	boolean	No	—	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.
`visual_search`	boolean	No	—	Whether to index the image for use with visual searches. Relevant for images only.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "access_control": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "access_type": {
            "type": "string",
            "enum": [
              "token",
              "anonymous"
            ],
            "description": "The type of access control to apply to the asset."
          },
          "key": {
            "type": "string",
            "description": "The authentication key identifier for token-based access. Default key is used if not specified or if set to 'default'."
          },
          "start": {
            "type": "string",
            "description": "The start date and time when anonymous access becomes available (ISO 8601 format)."
          },
          "end": {
            "type": "string",
            "description": "The end date and time when anonymous access expires (ISO 8601 format)."
          }
        },
        "required": [
          "access_type"
        ]
      },
      "description": "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."
    },
    "access_mode": {
      "type": "string",
      "description": "Allows the asset to behave as if it's of the authenticated 'type' (see above) 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. Valid values: public, and authenticated.",
      "enum": [
        "public",
        "authenticated"
      ]
    },
    "accessibility_analysis": {
      "type": "boolean",
      "description": "Whether to return return accessibility analysis values for the image."
    },
    "allowed_formats": {
      "type": "string",
      "description": "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 wont be converted."
    },
    "api_key": {
      "type": "string",
      "description": "The API key to use for the request. This is automatically computed by the Cloudinary's SDKs."
    },
    "asset_folder": {
      "type": "string",
      "description": "The asset folder to assign to the asset."
    },
    "async": {
      "type": "boolean",
      "description": "When set to true, returns the uploaded asset's public_id immediately in the response, before the upload is completed (asynchronously). Default: false."
    },
    "auto_chaptering": {
      "type": "boolean",
      "description": "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."
    },
    "auto_tagging": {
      "type": "number",
      "description": "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: - Cloudinary AI Content Analysis - Amazon Rekognition Celebrity Detection Use together with the categorization parameter for: - Google Automatic Video Tagging - Google Auto Tagging - Imagga Auto Tagging - Amazon Rekognition Auto Tagging"
    },
    "auto_transcription": {
      "description": "Auto Transcription"
    },
    "background_removal": {
      "type": "string",
      "description": "Automatically remove the background of an image using an add-on. - Set to cloudinary_ai to use the deep-learning based Cloudinary AI Background Removal add-on.   Optionally append a template suffix (e.g., cloudinary_ai:fine_edges). - 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. Relevant for images only."
    },
    "backup": {
      "type": "boolean",
      "description": "Whether to backup the uploaded asset. When set to true, backs up uploaded assets to a secondary storage bucket."
    },
    "callback": {
      "type": "string",
      "description": "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."
    },
    "categorization": {
      "type": "string",
      "description": "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)."
    },
    "cinemagraph_analysis": {
      "type": "boolean",
      "description": "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."
    },
    "colors": {
      "type": "boolean",
      "description": "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."
    },
    "context": {
      "type": "string",
      "description": "Key-value pairs of general textual context metadata to attach to the asset."
    },
    "custom_coordinates": {
      "type": "string",
      "description": "An array of coordinates for custom cropping."
    },
    "detection": {
      "type": "string",
      "description": "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."
    },
    "discard_original_filename": {
      "type": "boolean",
      "description": "Whether to discard the name of the original uploaded file. Relevant when delivering assets as attachments (setting the flag disposition:attachment in delivery URLs)."
    },
    "display_name": {
      "type": "string",
      "description": "A display name for the asset."
    },
    "eager": {
      "type": "string",
      "description": "A list of transformations to eagerly generate for the asset. Accepts either a single transformation or a pipe-separated list of transformations."
    },
    "eager_async": {
      "type": "boolean",
      "description": "Whether to generate the eager transformations asynchronously in the background after the upload request is completed rather than before the upload is completed."
    },
    "eager_notification_url": {
      "type": "string",
      "description": "A URL to notify when eager transformations are completed."
    },
    "evalScript": {
      "type": "string",
      "description": "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": {
      "type": "string",
      "description": "An array of coordinates representing detected faces in the asset, used for custom cropping or overlays."
    },
    "faces": {
      "type": "boolean",
      "description": "Whether to detect faces in the asset."
    },
    "file": {
      "type": "string",
      "description": "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://."
    },
    "filename_override": {
      "type": "string",
      "description": "Overrides the originally uploaded asset's file name in downloads that use flags like fl_attachment or fl_force_original."
    },
    "folder": {
      "type": "string",
      "description": "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."
    },
    "format": {
      "type": "string",
      "description": "An optional format to convert the uploaded asset to before saving in the cloud."
    },
    "headers": {
      "type": "string",
      "description": "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."
    },
    "invalidate": {
      "type": "boolean",
      "description": "Whether to invalidate CDN cache copies of a previously uploaded asset that shares the same public ID. Default: false."
    },
    "media_metadata": {
      "type": "boolean",
      "description": "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."
    },
    "metadata": {
      "type": "string",
      "description": "Structured metadata to attach to the asset based on the metadata fields defined for your account."
    },
    "moderation": {
      "type": "string",
      "description": "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."
    },
    "notification_url": {
      "type": "string",
      "description": "A URL to notify when the asset is ready."
    },
    "ocr": {
      "type": "string",
      "description": "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)."
    },
    "on_success": {
      "type": "string",
      "description": "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."
    },
    "overwrite": {
      "type": "boolean",
      "description": "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)."
    },
    "phash": {
      "type": "boolean",
      "description": "Whether to return the perceptual hash (pHash) on the uploaded image for image similarity detection."
    },
    "proxy": {
      "type": "string",
      "description": "A proxy to use for fetching remote URLs. The format should be http://hostname:port."
    },
    "public_id": {
      "type": "string",
      "description": "The identifier that is used for accessing the uploaded asset. If not specified, a unique ID is generated automatically."
    },
    "public_id_prefix": {
      "type": "string",
      "description": "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."
    },
    "quality_analysis": {
      "type": "boolean",
      "description": "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."
    },
    "raw_convert": {
      "type": "string",
      "description": "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)"
    },
    "regions": {
      "type": "string",
      "description": "Regions to detect in the asset."
    },
    "responsive_breakpoints": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "create_derived": {
            "type": "boolean",
            "description": "Create Derived"
          },
          "max_width": {
            "type": "integer",
            "description": "Max Width"
          },
          "min_width": {
            "type": "integer",
            "description": "Min Width"
          },
          "bytes_step": {
            "type": "integer",
            "description": "Bytes Step"
          },
          "max_images": {
            "type": "integer",
            "description": "Max Images"
          },
          "transformation": {
            "type": "string",
            "description": "The transformation value"
          }
        }
      },
      "description": "Settings to automatically generate breakpoints for responsive images."
    },
    "return_delete_token": {
      "type": "boolean",
      "description": "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."
    },
    "signature": {
      "type": "string",
      "description": "(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters."
    },
    "tags": {
      "type": "string",
      "description": "A comma-separated list of tag names to assign to the asset."
    },
    "timestamp": {
      "type": "integer",
      "description": "The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs."
    },
    "transformation": {
      "type": "string",
      "description": "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."
    },
    "type": {
      "type": "string",
      "description": "The delivery type that defines if and how the uploaded asset is available for public delivery. By default, all uploaded assets are public (upload). Possible values are upload, authenticated, private or asset.",
      "enum": [
        "upload",
        "authenticated",
        "private",
        "asset"
      ]
    },
    "unique_display_name": {
      "type": "boolean",
      "description": "Whether the display name should be unique."
    },
    "unique_filename": {
      "type": "boolean",
      "description": "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)."
    },
    "upload_preset": {
      "type": "string",
      "description": "(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."
    },
    "use_asset_folder_as_public_id_prefix": {
      "type": "boolean",
      "description": "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."
    },
    "use_filename": {
      "type": "boolean",
      "description": "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."
    },
    "use_filename_as_display_name": {
      "type": "boolean",
      "description": "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."
    },
    "visual_search": {
      "type": "boolean",
      "description": "Whether to index the image for use with visual searches. Relevant for images only."
    }
  },
  "required": [
    "PCID",
    "file"
  ]
}

​Tools

​cloudinary_assets_create_asset_relations_by_asset_id

​cloudinary_assets_create_asset_relations_by_public_id

​cloudinary_assets_delete_asset_relations_by_asset_id

​cloudinary_assets_delete_asset_relations_by_public_id

​cloudinary_assets_delete_backup_versions

​cloudinary_assets_delete_resources_by_public_id

​cloudinary_assets_derived_destroy

​cloudinary_assets_destroy_asset

​cloudinary_assets_destroy_by_asset_id

​cloudinary_assets_download_asset

​cloudinary_assets_download_backup_asset

​cloudinary_assets_explicit_asset

​cloudinary_assets_explode_resource

​cloudinary_assets_generate_archive

​cloudinary_assets_get_resource_by_asset_id

​cloudinary_assets_get_resource_by_public_id

​cloudinary_assets_get_video_views

​cloudinary_assets_list_images

​cloudinary_assets_list_raw_files

​cloudinary_assets_list_resource_tags

​cloudinary_assets_list_resource_types

​cloudinary_assets_list_resources_by_asset_folder

​cloudinary_assets_list_resources_by_asset_ids

​cloudinary_assets_list_resources_by_context

​cloudinary_assets_list_resources_by_external_ids

​cloudinary_assets_list_resources_by_moderation_kind_and_status

​cloudinary_assets_list_videos

​cloudinary_assets_rename_asset

​cloudinary_assets_restore_resources_by_asset_ids

​cloudinary_assets_text

​cloudinary_assets_update_resource_by_asset_id

​cloudinary_assets_update_resource_by_public_id

​cloudinary_assets_upload

​cloudinary_assets_upload_chunk

​cloudinary_assets_upload_no_resource_type

Tools

cloudinary_assets_create_asset_relations_by_asset_id

cloudinary_assets_create_asset_relations_by_public_id

cloudinary_assets_delete_asset_relations_by_asset_id

cloudinary_assets_delete_asset_relations_by_public_id

cloudinary_assets_delete_backup_versions

cloudinary_assets_delete_resources_by_public_id

cloudinary_assets_derived_destroy

cloudinary_assets_destroy_asset

cloudinary_assets_destroy_by_asset_id

cloudinary_assets_download_asset

cloudinary_assets_download_backup_asset

cloudinary_assets_explicit_asset

cloudinary_assets_explode_resource

cloudinary_assets_generate_archive

cloudinary_assets_get_resource_by_asset_id

cloudinary_assets_get_resource_by_public_id

cloudinary_assets_get_video_views

cloudinary_assets_list_images

cloudinary_assets_list_raw_files

cloudinary_assets_list_resource_tags

cloudinary_assets_list_resource_types

cloudinary_assets_list_resources_by_asset_folder

cloudinary_assets_list_resources_by_asset_ids

cloudinary_assets_list_resources_by_context

cloudinary_assets_list_resources_by_external_ids

cloudinary_assets_list_resources_by_moderation_kind_and_status

cloudinary_assets_list_videos

cloudinary_assets_rename_asset

cloudinary_assets_restore_resources_by_asset_ids

cloudinary_assets_text

cloudinary_assets_update_resource_by_asset_id

cloudinary_assets_update_resource_by_public_id

cloudinary_assets_upload

cloudinary_assets_upload_chunk

cloudinary_assets_upload_no_resource_type