View as Markdown
Cloudinary icon

Cloudinary ACTION

Resource Transformation

Transforms image or video resources on-the-fly. It allows transformation options for resource optimization (i.e. web viewing), resize and crop the resources, etc. Image transformation documentation. Video transformation documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Cloudinary account once, then configure and run Resource Transformation from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "cloudinary-resource-transformation",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    cloudinary: { authProvisionId: "apn_xxxxxxx" },
    resourceType: "Resource Type",
    options: "Options",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Resource Transformation inputs
Property Type Description
resourceType Resource Type string
Type of the resource to upload. Valid values: image, video.
Optional
options Options string
For an image resourceType, use this parameter to set the image transformation options to apply and/or the URL parameters supported by Cloudinary API. For all transformation options, please check Image transformation API reference, for URL parameters, please check Transforming media assets using dynamic URLs. For a video resourceType, use this parameter to set video transformation options to apply and/or the URL parameters supported by Cloudinary API. For all transformation options, please check Video transformation API reference, for URL parameters, please check Transforming media assets using dynamic URLs.
Required
imageSource Image Source string
If resourceType is an image, use this parameter to point to the source of the image to apply transformations on. It can be a local file, the actual image data, a remote FTP, HTTP or HTTPS URL address of an existing image. For details and examples, see: file source options.
Optional
videoPublicId Video Public Id string
If resourceType is a video, use this parameter to set the public id of the video to apply transformations on. The public id is the unique identifier of the video, and is either specified when uploading the video to your Cloudinary account, or automatically assigned by Cloudinary. For more details on the options for specifying the public id, see Public ID - the image identifier.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
cloudinary-resource-transformation
Version
0.2.2
App
Cloudinary
Authentication
API key
Behavior
May modify external data