NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

Cloudinary

cloudinary

Cloudinary is a cloud-based media management platform for uploading, storing, transforming, and delivering images and videos via CDN.

Images & DesignVideo & AudioWeb del proveedor
Acciones
34
Triggers
0
Autenticación
—
OAuth gestionado
No
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (34)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Create FolderCLOUDINARY_CREATE_FOLDERAcción

Tool to create a new asset folder. use when you need to organize assets into nested directories. use after confirming the folder path does not already exist.

Parámetros de entrada

  • folderstringObligatorio

    Full path of the new asset folder (e.g., 'images/events/2023').

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create Metadata FieldCLOUDINARY_CREATE_METADATA_FIELDAcción

Tool to create a new metadata field definition. use when extending your metadata schema with new fields.

Parámetros de entrada

  • typestringObligatorioenum

    Data type of the metadata field.

    stringintegerdateenumset
  • labelstringObligatorio

    Human-readable label shown in the UI.

  • mandatoryboolean

    Whether a value is required (default false).

  • datasourceobject

    Predefined list of values for enum or set metadata fields.

  • validationobject

    Validation rules object, e.g. greater_than, strlen, strregex.

  • external_idstring

    Unique ID for the field (max 255 chars). Auto-generated if omitted.

  • restrictionsobject

    UI restrictions object, e.g., {'readonly_ui': True}.

  • default_valueinteger

    Default value for the field. Required if mandatory=true. Use list for 'set'.

  • default_disabledboolean

    Disable field by default for new assets (default false).

  • allow_dynamic_list_valuesboolean

    Allow dynamic additions of set values (for 'set' type).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create TriggerCLOUDINARY_CREATE_TRIGGERAcción

Tool to create a new webhook trigger for a specified event type. use after configuring your webhook endpoint and choosing the event type. example: "create a trigger for uploads to https://example.com/hooks/cloudinary"

Parámetros de entrada

  • uristringObligatorio

    HTTPS URL to receive webhook notifications.

  • event_typestringObligatorioenum

    The event type that triggers the webhook notification.

    allaccess_control_changedbulk_refresh_auto_fetchcreate_folderdeletedelete_by_tokendelete_foldereagererrorexplodegenerate_archiveinfo+16

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create Upload MappingCLOUDINARY_CREATE_UPLOAD_MAPPINGAcción

Tool to create a new upload mapping folder and url template. use when you need to dynamically map external url prefixes to a cloudinary asset folder before uploading files.

Parámetros de entrada

  • folderstringObligatorio

    The name of the folder to map.

  • templatestringObligatorio

    The URL prefix to be mapped to the folder.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create Upload PresetCLOUDINARY_CREATE_UPLOAD_PRESETAcción

Tool to create a new upload preset. use when defining centralized upload options (tags, formats, transformations, etc.) before asset uploads.

Parámetros de entrada

  • ocrstring

    OCR add-on to apply.

  • namestring

    Name for the new preset. If omitted, Cloudinary generates one.

  • tagsstring

    Comma-separated list of tags to apply to uploads.

  • eagerstring

    Eager transformations to generate on upload (e.g., 'c_fill,g_face,h_150,w_150').

  • proxyanyuri

    Proxy URL for the upload request.

  • folderstring

    Folder path in your Cloudinary account to store uploads.

  • contextstring

    Context metadata in key=value|key2=value2 format.

  • callbackanyuri

    Callback URL to send upload responses.

  • unsignedboolean

    Allow unsigned uploads using this preset.

  • detectionstring

    Detection add-on to apply (e.g., 'adv_face').

  • overwriteboolean

    Overwrite any existing asset with the same public_id.

  • moderationstringenum

    Type of moderation to apply (if any).

    manualwebpurifyaws_rekaws_rek_videoperception_pointgoogle_video_moderationduplicate
  • auto_taggingnumber

    Confidence threshold (0.0-1.0) for auto-tagging.

  • use_filenameboolean

    Use the original filename of the uploaded asset.

  • resource_typestringenum

    Asset type this preset applies to.

    imagevideoraw
  • categorizationstring

    Comma-separated list of categorization add-on(s) to apply.

  • transformationstring

    Incoming transformation to apply on upload (e.g., 'c_limit,w_500').

  • allowed_formatsstring

    Comma-separated list of allowed formats (e.g., jpg,png).

  • unique_filenameboolean

    Append a random suffix to the filename to avoid collisions.

  • notification_urlanyuri

    Webhook URL to receive upload notifications.

  • quality_analysisboolean

    Whether to perform quality analysis.

  • background_removalstringenum

    Background removal add-on to apply.

    cloudinary_aipixelz
  • cinemagraph_analysisboolean

    Whether to perform cinemagraph analysis.

  • accessibility_analysisboolean

    Whether to perform accessibility analysis.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete Derived ResourcesCLOUDINARY_DELETE_DERIVED_RESOURCESAcción

Tool to delete derived assets. use when you need to remove specific derived assets by their ids. example: "delete derived assets with ids [id1, id2]".

Parámetros de entrada

  • derived_resource_idsstring[]Obligatorio

    Array of up to 100 derived resource IDs to delete.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete Metadata Field Datasource EntriesCLOUDINARY_DELETE_ENTRIES_IN_METADATA_FIELD_DATASOURCEAcción

Tool to delete datasource entries for a specified metadata field. use when you need to soft-delete (inactivate) specific entries in a field's datasource. example prompt: "delete entries ['color1','color2'] from metadata field 'color id'"

Parámetros de entrada

  • external_idstringObligatorio

    External ID of the metadata field whose datasource entries will be deleted.

  • external_idsstring[]Obligatorio

    List of datasource entry external IDs to delete (inactivate).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete FolderCLOUDINARY_DELETE_FOLDERAcción

Tool to delete an empty asset folder. use when the folder is confirmed empty and you need to remove it.

Parámetros de entrada

  • folderstringObligatorio

    Full path of the empty folder to delete (e.g., 'product/test').

  • skip_backupboolean

    Whether to delete the folder even if it contains backed up assets. Default: false.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete Metadata FieldCLOUDINARY_DELETE_METADATA_FIELDAcción

Tool to delete a metadata field by external id. use when you need to remove a metadata field that is no longer required.

Parámetros de entrada

  • external_idstringObligatorio

    External ID of the metadata field to delete.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete Resources by Asset IDCLOUDINARY_DELETE_RESOURCES_BY_ASSET_IDAcción

Tool to delete resources by asset ids. use when you need to permanently remove specific resources by their immutable asset ids; irreversible.

Parámetros de entrada

  • asset_idsstring[]Obligatorio

    Array of up to 100 immutable Cloudinary asset IDs to delete.

  • invalidateboolean

    Whether to also invalidate CDN cache for deleted assets.

  • keep_originalboolean

    If true, only delete derived resources, keeping the original assets.

  • transformationsstring[]

    List of transformation strings; only delete derived resources matching these transformations.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete Resources by TagsCLOUDINARY_DELETE_RESOURCES_BY_TAGSAcción

Tool to delete cloudinary assets by tag. use when you need to remove all assets associated with a given tag.

Parámetros de entrada

  • tagstringObligatorio

    Name of the tag whose resources should be deleted.

  • invalidateboolean

    If true, invalidate CDN cached copies of deleted resources.

  • next_cursorstring

    Cursor for pagination when deleting more than 1000 resources.

  • keep_originalboolean

    If true, delete only derived assets and keep originals.

  • resource_typestringenum

    Type of asset to delete. Use 'video' for both video and audio assets.

    imagerawvideo
  • transformationsstring

    Comma-separated transformation hashes to delete matching derived resources.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete TriggerCLOUDINARY_DELETE_TRIGGERAcción

Tool to delete a trigger (webhook notification). use when you need to remove a trigger by its id after confirming the correct id.

Parámetros de entrada

  • trigger_idstringObligatorio

    The unique identifier of the trigger (webhook) to delete.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Adaptive Streaming ProfilesCLOUDINARY_GET_ADAPTIVE_STREAMING_PROFILESAcción

Tool to list adaptive streaming profiles. use when retrieving built-in and custom adaptive streaming profiles for delivering video via hls or dash.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobject[]Obligatorio

    List of adaptive streaming profiles (built-in and custom).

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get product environment config detailsCLOUDINARY_GET_CONFIGAcción

Tool to get product environment config details. use when you need to fetch or verify environment configuration such as folder mode.

Parámetros de entrada

  • settingsboolean

    Whether to include the current configuration settings in the response (e.g., folder_mode).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Metadata Field By IDCLOUDINARY_GET_METADATA_FIELD_BY_IDAcción

Tool to get a single metadata field definition by external id. use after creating or updating a metadata field to fetch its full definition. example: "get metadata field definition for external id 'color id'."

Parámetros de entrada

  • external_idstringObligatorio

    External ID of the metadata field to retrieve.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Resource by Asset IDCLOUDINARY_GET_RESOURCE_BY_ASSET_IDAcción

Get resource by asset id

Parámetros de entrada

  • facesboolean

    Include detected face coordinates

  • pagesboolean

    Include page count for multi-page documents

  • phashboolean

    Include perceptual hash for similarity detection

  • colorsboolean

    Include color histogram and predominant colors

  • asset_idstringObligatorio

    Unique immutable asset ID

  • versionsboolean

    Include backed-up version details

  • coordinatesboolean

    Include custom crop and face coordinates

  • max_resultsinteger

    Max derived assets to return (1-500)

  • image_metadataboolean

    Include IPTC, XMP, Exif metadata (returns ETag)

  • quality_analysisboolean

    Include image quality analysis scores

  • derived_next_cursorstring

    Cursor for next page of derived assets

  • accessibility_analysisboolean

    Include accessibility analysis scores

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Resource by Public IDCLOUDINARY_GET_RESOURCE_BY_PUBLIC_IDAcción

Tool to get details of a single resource by public id. use when you need full asset, derived, and related info.

Parámetros de entrada

  • typestringObligatorioenum

    Delivery type: upload, private, etc.

    uploadprivateauthenticatedfetchfacebooktwittergravataryoutubehuluvimeoanimotoworldstarhiphop+2
  • facesboolean

    Include detected face coordinates

  • pagesboolean

    Include page count for multi-page files

  • phashboolean

    Include perceptual hash for similarity detection

  • colorsboolean

    Include color histogram and predominant colors

  • relatedboolean

    Include list of related assets

  • versionsboolean

    Include backed-up versions of the resource

  • public_idstringObligatorio

    Public ID of the resource

  • coordinatesboolean

    Include custom cropping and face coordinates

  • max_resultsinteger

    Max number of derived or related assets to return (1-500)

  • resource_typestringObligatorioenum

    Resource type: image, video, or raw

    imagevideoraw
  • media_metadataboolean

    Include IPTC, XMP, and detailed metadata (returns ETag)

  • quality_analysisboolean

    Include image quality analysis scores

  • derived_next_cursorstring

    Cursor for next page of derived assets

  • related_next_cursorstring

    Cursor for next page of related assets

  • accessibility_analysisboolean

    Include accessibility analysis scores

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Resources by Asset FolderCLOUDINARY_GET_RESOURCES_BY_ASSET_FOLDERAcción

Tool to list assets stored directly in a specified folder. use when you need to view assets in a specific folder without including subfolder contents.

Parámetros de entrada

  • max_resultsinteger

    Maximum number of assets to return (1-500). Defaults to 50.

  • next_cursorstring

    Cursor for pagination; include to fetch the next page of results.

  • asset_folderstringObligatorio

    Name of the asset folder (case-insensitive) to list assets from.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Resources by ContextCLOUDINARY_GET_RESOURCES_BY_CONTEXTAcción

Tool to retrieve assets with a specified contextual metadata key/value. use when filtering resources by context metadata.

Parámetros de entrada

  • keystringObligatorio

    Contextual metadata key to filter assets on (required).

  • tagsboolean

    Include tag list for each asset.

  • valuestring

    Contextual metadata value to filter assets. If omitted, returns all assets with the given key.

  • fieldsstring

    Comma-separated list of resource fields to include in each asset.

  • contextboolean

    Include contextual metadata key/value pairs for each asset.

  • metadataboolean

    Include structured metadata fields for each asset.

  • directionstringenum

    Order by created_at date. 'desc' or '-1' (default) for newest first, 'asc' or '1' for oldest first.

    desc-1asc1
  • max_resultsinteger

    Maximum number of assets to return (1-500). Defaults to 10.

  • moderationsboolean

    Include image moderation status for each asset.

  • next_cursorstring

    Cursor for pagination; include to fetch the next page of results.

  • resource_typestringenum

    Type of asset to list. Defaults to 'image'.

    imagerawvideo

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Resources in ModerationCLOUDINARY_GET_RESOURCES_IN_MODERATIONAcción

Tool to retrieve assets in a moderation queue by status. use after moderation to process pending or reviewed assets.

Parámetros de entrada

  • tagsboolean

    Include tags in the response.

  • fieldsstring

    Comma-separated list of fields to include in the response.

  • statusstringObligatorioenum

    Moderation status to filter by.

    pendingapprovedrejectedqueuedaborted
  • contextboolean

    Include contextual metadata in the response.

  • metadataboolean

    Include structured metadata in the response.

  • directionstringenum

    Sort direction of returned results.

    ascdesc1-1
  • max_resultsinteger

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

  • moderationsboolean

    Include asset moderation info in the response.

  • next_cursorstring

    Cursor for pagination to fetch the next page.

  • resource_typestringenum

    Type of resource to query; use 'video' for all videos and audio.

    imagerawvideo
  • moderation_kindstringObligatorioenum

    Moderation list type to query.

    manualwebpurifyaws_rekaws_rek_videoperception_pointgoogle_video_moderationduplicate

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Root FoldersCLOUDINARY_GET_ROOT_FOLDERSAcción

Tool to list all root folders in the product environment. use when you need to retrieve top-level asset folders.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Streaming Profile DetailsCLOUDINARY_GET_STREAMING_PROFILE_DETAILSAcción

Tool to get details of a single streaming profile by name. use when you need to inspect an existing profile's configuration before making changes. example: "get details of streaming profile 'hd'."

Parámetros de entrada

  • namestringObligatorio

    The name of the streaming profile to retrieve

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Resource TagsCLOUDINARY_GET_TAGSAcción

Tool to list all tags used for a specified resource type. use when you need to retrieve or page through the tags assigned to your assets.

Parámetros de entrada

  • prefixstring

    Only return tags that start with this prefix.

  • max_resultsinteger

    Max number of tags to return (1-500). Default: 10.

  • next_cursorstring

    Opaque cursor for pagination. Pass from prior response to get next page.

  • resource_typestringenum

    The resource type to list tags for. 'image' (default), 'video' (for both video/audo), or 'raw'.

    imagevideoraw

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get TransformationsCLOUDINARY_GET_TRANSFORMATIONSAcción

Tool to list all transformations (named and unnamed). use when you need to retrieve transformation definitions or paginate through transformation records.

Parámetros de entrada

  • max_resultsinteger

    Maximum number of transformations to return (1-500). Defaults to 10.

  • next_cursorstring

    Cursor for pagination to retrieve the next set of results.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Webhook TriggersCLOUDINARY_GET_TRIGGERSAcción

Tool to list all webhook triggers for event types in your environment. use when you need to retrieve or filter existing triggers by type.

Parámetros de entrada

  • event_typestring

    Filter triggers by a specific event type (e.g., 'upload')

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Upload Mapping DetailsCLOUDINARY_GET_UPLOAD_MAPPING_DETAILSAcción

Tool to retrieve details of a single upload mapping by folder. use when you need the url prefix template associated with a specific mapping folder.

Parámetros de entrada

  • folderstringObligatorio

    Name of the upload mapping folder to retrieve details for.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Upload MappingsCLOUDINARY_GET_UPLOAD_MAPPINGSAcción

Tool to list all upload mappings by folder. use when you need to retrieve and paginate through upload mapping configurations, optionally filtering by folder.

Parámetros de entrada

  • folderstring

    Name of a specific upload-mapping folder to retrieve; omit to list all folders.

  • max_resultsinteger

    Maximum number of mappings to return (1-500). If omitted, the server default is applied.

  • next_cursorstring

    Cursor for paginating through results; omit or unset to start at the first page.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get UsageCLOUDINARY_GET_USAGEAcción

Tool to get product environment usage details. use when you need to monitor your cloudinary account storage, bandwidth, requests, and other usage limits.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Order Metadata Field DatasourceCLOUDINARY_ORDER_METADATA_FIELD_DATASOURCEAcción

Tool to update ordering of a metadata field datasource. use when you need to reorder enum or set values for a metadata field datasource before updating assets.

Parámetros de entrada

  • order_bystringObligatorio

    The criteria for sorting the datasource; currently supports only 'value'.

  • directionstringObligatorioenum

    The direction for sorting: 'asc' (ascending) or 'desc' (descending).

    ascdesc
  • external_idstringObligatorio

    The external ID of the metadata field whose datasource will be reordered.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Ping Cloudinary ServersCLOUDINARY_PING_CLOUDINARY_SERVERSAcción

Tool to ping cloudinary servers. use when testing api reachability and authentication.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Restore Metadata Field Datasource EntriesCLOUDINARY_RESTORE_ENTRIES_IN_METADATA_FIELD_DATASOURCEAcción

Tool to restore previously deleted datasource entries for a metadata field. use after deleting entries to reactivate soft-deleted datasource entries.

Parámetros de entrada

  • external_idstringObligatorio

    External ID of the metadata field whose datasource entries will be restored.

  • external_idsstring[]Obligatorio

    List of datasource entry external IDs to restore (unblock).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Search FoldersCLOUDINARY_SEARCH_FOLDERSAcción

Tool to search asset folders with filtering, sorting, and pagination. use when you need to locate specific folders by name, path, or creation date.

Parámetros de entrada

  • sort_bystring[]

    List of sort fields and directions, e.g. ['name:asc','created_at:desc']. Valid fields: name, path, created_at, updated_at; directions: asc or desc.

  • expressionstring

    Lucene-like search expression to filter folders. For example: 'name:sample AND created_at>1w'.

  • max_resultsinteger

    Maximum number of folders to return (1-500). Default is 50.

  • next_cursorstring

    Cursor for next page of results, from a prior response's next_cursor.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update FolderCLOUDINARY_UPDATE_FOLDERAcción

Tool to rename or move an existing asset folder. use when you need to change the folder's name or location.

Parámetros de entrada

  • folderstringObligatorio

    Full path of the existing asset folder to update, e.g., 'product/test'.

  • to_folderstringObligatorio

    New full path of the asset folder. Changing only the last component renames, only the path moves, or both.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update Metadata FieldCLOUDINARY_UPDATE_METADATA_FIELDAcción

Tool to update a metadata field definition by external id. use when modifying an existing schema field (e.g., changing label or validation) without redefining all properties.

Parámetros de entrada

  • labelstring

    New label for the metadata field.

  • mandatoryboolean

    Whether the field is mandatory.

  • datasourceobject

    Predefined list of values for enum or set metadata fields.

  • validationobject

    Validation rules for the metadata field.

  • external_idstringObligatorio

    External ID of the metadata field to update.

  • restrictionsobject

    UI restrictions object, e.g., {'readonly_ui': True}.

  • default_valueinteger

    Default value for the field (list for 'set' type).

  • default_disabledboolean

    Whether the field is disabled by default for new assets.

  • allow_dynamic_list_valuesboolean

    Allow dynamic additions of list values (for 'set' type).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not