Cloudinary

List all metadata rules. Metadata rules automatically apply metadata based on conditions. Args: - format: Response format

Publish resources (make them available via CDN). Args: - publicIds: Array of public IDs to publish (required) - resourceType: Type of resource - default: image

Get usage statistics for your Cloudinary account. Returns information about: - Plan type - Transformations, storage, bandwidth usage - Resource counts - Media size limits Args: - date: Optional date to get historical usage (format: YYYY-MM-DD or "last-7-days", "last-30-days", etc.) - format: Response format

Get your Cloudinary account configuration settings. Returns account settings including folder mode, security settings, and more. Args: - format: Response format

List all resource types in your account (typically: image, video, raw). Args: - format: Response format

Update the access mode for all resources matching a prefix. Args: - prefix: Public ID prefix to match (required) - accessMode: New access mode - public or authenticated (required) - resourceType: Type of resource - default: image - deliveryType: Delivery type - default: upload

Update the access mode for all resources with a specific tag. Args: - tag: Tag to match (required) - accessMode: New access mode - public or authenticated (required) - resourceType: Type of resource - default: image

Update the access mode for specific resources by their public IDs. Args: - publicIds: Array of public IDs (required) - accessMode: New access mode - public or authenticated (required) - resourceType: Type of resource - default: image - deliveryType: Delivery type - default: upload

Run AI analysis on a resource. Requires AI add-ons to be enabled. Args: - inputType: Input type - uri (required) - uri: URI of the resource to analyze (required) - analysisType: Type of analysis to perform (required) - captioning: Generate captions - tagging: Auto-tag content - moderation: Content moderation - etc.

List root-level folders in your Cloudinary account. Args: - maxResults: Number of folders to return (default: 100) - nextCursor: Pagination cursor - format: Response format

List subfolders within a specific folder path. Args: - path: Parent folder path (required) - maxResults: Number of folders to return (default: 100) - nextCursor: Pagination cursor - format: Response format

Create a new folder at the specified path. Args: - path: Full folder path to create (required) Note: Parent folders are created automatically if they don't exist.

Rename/move a folder to a new path. Args: - fromPath: Current folder path (required) - toPath: New folder path (required) Note: This updates the folder path for all resources in the folder.

Delete a folder. Args: - path: Folder path to delete (required) Note: The folder must be empty before it can be deleted.

List all structured metadata field definitions. Args: - format: Response format

Get details of a specific metadata field. Args: - fieldId: External ID of the field (required) - format: Response format

Create a new structured metadata field. Args: - externalId: Unique external ID for the field - label: Display label (required) - type: Field type - string, integer, date, enum, or set (required) - mandatory: Whether the field is required (default: false) - defaultValue: Default value for the field - datasource: For enum/set types, array of values with {value, external_id}

Update an existing metadata field. Args: - fieldId: External ID of the field (required) - label: New display label - mandatory: Whether the field is required - defaultValue: New default value

Delete a metadata field definition. Args: - fieldId: External ID of the field to delete (required)

Update the datasource values for an enum/set metadata field. Args: - fieldId: External ID of the field (required) - values: Array of datasource entries with {value, external_id} (required)

Soft-delete (deactivate) datasource entries for a metadata field. Args: - fieldId: External ID of the field (required) - externalIds: Array of datasource entry external IDs to deactivate (required)

Restore (reactivate) previously deleted datasource entries. Args: - fieldId: External ID of the field (required) - externalIds: Array of datasource entry external IDs to restore (required)

Reorder metadata fields. Args: - order: Array of field external IDs in desired order (required)

Create a new metadata rule. Args: - name: Rule name (required) - condition: Condition object defining when the rule applies (required) - result: Result object defining the metadata to apply (required) - state: Rule state - active or inactive (default: active)

Update an existing metadata rule. Args: - ruleId: Rule ID (required) - name: New rule name - condition: New condition object - result: New result object - state: New state (active or inactive)

Delete a metadata rule. Args: - ruleId: Rule ID to delete (required)

List all upload presets in your Cloudinary account. Upload presets define default upload options that can be applied to uploads. Args: - maxResults: Number of presets to return (default: 100) - nextCursor: Pagination cursor - format: Response format

Get details of a specific upload preset. Args: - name: Preset name (required) - format: Response format

Create a new upload preset. Args: - name: Preset name (required) - unsigned: Allow unsigned uploads (default: false) - folder: Default folder for uploads - tags: Default tags (comma-separated) - transformation: Default transformation to apply - format: Default output format - accessMode: Access mode (public or authenticated) - overwrite: Allow overwriting existing resources - useFilename: Use original filename as public ID - uniqueFilename: Append random characters to filename

Update an existing upload preset. Args: - name: Preset name (required) - unsigned: Allow unsigned uploads - folder: Default folder for uploads - tags: Default tags (comma-separated) - transformation: Default transformation to apply - format: Default output format - accessMode: Access mode (public or authenticated) - overwrite: Allow overwriting existing resources - useFilename: Use original filename as public ID - uniqueFilename: Append random characters to filename

Delete an upload preset. Args: - name: Preset name to delete (required)

List all upload mappings. Upload mappings define auto-upload rules that map folder paths to remote URLs. Args: - maxResults: Number of mappings to return (default: 100) - nextCursor: Pagination cursor - format: Response format

Get details of a specific upload mapping. Args: - folder: Folder name (required) - format: Response format

Create a new upload mapping for auto-upload. Args: - folder: Folder name for the mapping (required) - template: URL template for auto-upload (required) Example: folder: "external_images" template: "https://example.com/images/"

Update an existing upload mapping. Args: - folder: Folder name (required) - template: New URL template (required)

Delete an upload mapping. Args: - folder: Folder name to delete (required)

Get multiple resources by their public IDs in a single request. Args: - publicIds: Array of public IDs to retrieve (required) - resourceType: Type of resource - default: image - deliveryType: Delivery type - default: upload - format: Response format

Get multiple resources by their immutable asset IDs in a single request. Args: - assetIds: Array of asset IDs to retrieve (required) - format: Response format

List resources (assets) from Cloudinary with pagination. Returns a paginated list of resources. Use the cursor from the response to fetch the next page. Args: - resourceType: Type of resource (image, video, raw) - default: image - deliveryType: Delivery type (upload, private, authenticated, etc.) - default: upload - prefix: Filter by public ID prefix - maxResults: Number of resources to return (1-500, default: 20) - nextCursor: Pagination cursor from previous response - tags: Include tags in response - context: Include context metadata in response - moderations: Include moderation status - metadata: Include structured metadata - format: Response format ('json' or 'markdown')

List resources that have a specific tag. Args: - tag: The tag to filter by (required) - resourceType: Type of resource (image, video, raw) - default: image - maxResults: Number of resources to return - nextCursor: Pagination cursor - format: Response format

List resources that have a specific context key/value. Args: - key: Context key to filter by (required) - value: Context value to filter by (optional) - resourceType: Type of resource - default: image - maxResults: Number of resources to return - nextCursor: Pagination cursor - format: Response format

List resources in a specific asset folder. Args: - folder: Asset folder path (required) - maxResults: Number of resources to return - nextCursor: Pagination cursor - format: Response format

Get detailed information about a specific resource by public ID. Args: - publicId: The public ID of the resource (required) - resourceType: Type of resource (image, video, raw) - default: image - deliveryType: Delivery type - default: upload - format: Response format

Get detailed information about a specific resource by its immutable asset ID. Args: - assetId: The asset ID of the resource (required) - format: Response format

Update a resource's metadata, tags, context, or other attributes. Args: - publicId: The public ID of the resource (required) - resourceType: Type of resource - default: image - deliveryType: Delivery type - default: upload - tags: Array of tags to set - context: Context metadata object - metadata: Structured metadata object - moderationStatus: Set moderation status (pending, approved, rejected) - assetFolder: Move to a different asset folder - displayName: Set display name

Delete one or more resources by their public IDs. Args: - publicIds: Array of public IDs to delete (required) - resourceType: Type of resource - default: image - deliveryType: Delivery type - default: upload

Delete all resources with a specific public ID prefix. WARNING: This can delete many resources at once. Args: - prefix: Public ID prefix to match (required) - resourceType: Type of resource - default: image - deliveryType: Delivery type - default: upload

Delete all resources with a specific tag. WARNING: This can delete many resources at once. Args: - tag: Tag to match (required) - resourceType: Type of resource - default: image

Restore backed-up resources that were deleted. Args: - publicIds: Array of public IDs to restore (required) - resourceType: Type of resource - default: image - deliveryType: Delivery type - default: upload

List resources by their moderation status. Args: - kind: Moderation kind (e.g., 'aws_rek', 'manual', 'webpurify') (required) - status: Moderation status - pending, approved, or rejected (required) - resourceType: Type of resource - default: image - maxResults: Number of resources to return - nextCursor: Pagination cursor - format: Response format

Add related assets to a resource. Args: - publicId: The public ID of the primary resource (required) - assetsToRelate: Array of asset IDs to relate (required) - resourceType: Type of resource - default: image - deliveryType: Delivery type - default: upload

Remove related assets from a resource. Args: - publicId: The public ID of the primary resource (required) - assetsToUnrelate: Array of asset IDs to unrelate (required) - resourceType: Type of resource - default: image - deliveryType: Delivery type - default: upload

Search for resources using Cloudinary's powerful search API with Lucene-like query syntax. Examples of search expressions: - "folder:products" - resources in products folder - "tags:sale AND format:jpg" - JPG images with 'sale' tag - "uploaded_at>[2024-01-01]" - uploaded after Jan 1, 2024 - "width>1000 AND height>1000" - large images - "resource_type:video AND duration>60" - videos longer than 60 seconds - "context.category:electronics" - resources with specific context - "faces>0" - images with detected faces Args: - expression: Search expression in Lucene-like syntax (required) - maxResults: Number of results to return (1-500, default: 20) - nextCursor: Pagination cursor from previous response - sortBy: Array of sort fields with direction (e.g., [{"field": "created_at", "direction": "desc"}]) - aggregate: Fields to aggregate (e.g., ["format", "resource_type"]) - withField: Additional fields to include (e.g., ["tags", "context"]) - format: Response format ('json' or 'markdown')

Search for visually similar resources using image URL, asset ID, or text description. Requires Visual Search add-on to be enabled. Args: - imageUrl: URL of image to search for similar images - imageAssetId: Asset ID of image to search for similar images - text: Text description to search for matching images - format: Response format Note: Provide exactly one of imageUrl, imageAssetId, or text.

List all tags used in your Cloudinary account. Args: - resourceType: Type of resource (image, video, raw) - default: image - prefix: Filter tags by prefix - maxResults: Number of tags to return - nextCursor: Pagination cursor - format: Response format

List all streaming profiles in your Cloudinary account. Streaming profiles define video encoding settings for adaptive bitrate streaming (HLS/DASH). Args: - format: Response format

Get details of a specific streaming profile. Args: - name: Profile name (required) - format: Response format

Create a new streaming profile. Args: - name: Profile name (required) - displayName: Display name for the profile - representations: Array of representation objects with transformation settings (required) Example representations: [ { "transformation": { "width": 1920, "height": 1080, "bit_rate": "5000k" } }, { "transformation": { "width": 1280, "height": 720, "bit_rate": "2500k" } }, { "transformation": { "width": 854, "height": 480, "bit_rate": "1000k" } } ]

Update an existing streaming profile. Args: - name: Profile name (required) - displayName: New display name - representations: New representation settings

Delete a streaming profile. Args: - name: Profile name to delete (required) Note: Predefined profiles cannot be deleted.

List all transformations in your Cloudinary account. Args: - named: Filter to only named transformations (default: false) - maxResults: Number of transformations to return (default: 100) - nextCursor: Pagination cursor - format: Response format

Get details of a specific transformation. Args: - name: Transformation name or string (required) - format: Response format

Create a new named transformation. Args: - name: Name for the transformation (required) - transformation: Transformation string (required) Example: name: "thumbnail" transformation: "c_thumb,w_150,h_150,g_face"

Update an existing transformation. Args: - name: Transformation name or string (required) - allowedForStrict: Whether to allow for strict transformations - unsafeUpdate: New transformation string (use with caution)

Delete a transformation. Args: - name: Transformation name or string to delete (required) Note: Only transformations that are not in use can be deleted.

Delete derived (transformed) versions of resources by their IDs. Args: - derivedResourceIds: Array of derived resource IDs to delete (required)

Delete derived resources for specific transformations. Args: - publicIds: Array of public IDs (required) - transformations: Array of transformation strings to delete (required) - resourceType: Type of resource - default: image - deliveryType: Delivery type - default: upload