View as Markdown
AWS icon

AWS ACTION

S3 - Upload Files

Upload files to S3. Accepts either a file URL, a local file path, or a directory path. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's AWS account once, then configure and run S3 - Upload Files 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: "aws-s3-upload-files",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    aws: { authProvisionId: "apn_xxxxxxx" },
    region: "AWS Region",
    bucket: "S3 Bucket Name",
  },
})

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.

S3 - Upload Files inputs
Property Type Description
region AWS Region string
The AWS region tied to your S3, e.g us-east-1 or us-west-2
Required Dynamic
bucket S3 Bucket Name string
The S3 Bucket Name
Required Dynamic
prefix Prefix string
This is the destination S3 prefix. Files or folders would both get uploaded to the prefix.
Required
path File Path, Url, Or Folder Path string
Provide either a file URL, a path to a file in the /tmp directory (for example, /tmp/myFile.pdf), or a directory path to upload all files.
Required
customFilename S3 Filename Key string
The name of the S3 key with extension you'd like to upload this file to
Optional
syncDir SyncDir dir
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
aws-s3-upload-files
Version
0.0.7
App
AWS
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes