View as Markdown
Pexels icon

Pexels ACTION

Download Photo

Download a specific photo by providing its photo ID and optionally choosing the desired size. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Pexels account once, then configure and run Download Photo 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: "pexels-download-photo",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    pexels: { authProvisionId: "apn_xxxxxxx" },
    photoId: "Photo ID",
    filePath: "File Path",
  },
})

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.

Download Photo inputs
Property Type Description
photoId Photo ID string
The ID of the photo to retrieve or download.
Required
filePath File Path string
The destination path in /tmp for the downloaded the file (e.g., /tmp/myFile.jpg). Make sure to include the file extension.
Required
syncDir SyncDir dir
Required

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
pexels-download-photo
Version
0.0.3
App
Pexels
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes