AWS S3

The AWS S3 node provides full integration with Amazon Simple Storage Service (S3). Operations are organized into three groups: file operations (upload, download, delete, list), bucket operations (create, delete, list), and folder operations (create, delete, list). This node is commonly used for file archival, data exchange between systems, and backup workflows.

Before You Use This Node

What you may need	Where to set it up	Why it matters
AWS S3 connection	Connections	Save AWS access details once, then reuse them for bucket, folder, and file actions.
Files to upload or store	Files	Files can be stored in cloud storage or local storage and reused in S3 steps.
Bucket names, folder paths, or file name patterns	Global Variables	Keep common S3 values consistent across workflows.

Actions

File Operations

Action	Description
awsS3:file:upload	Upload a file to an S3 bucket
awsS3:file:download	Download a file from an S3 bucket
awsS3:file:delete	Delete a file from an S3 bucket
awsS3:file:list	List files in a bucket or prefix

Bucket Operations

Action	Description
awsS3:bucket:create	Create a new S3 bucket
awsS3:bucket:delete	Delete an S3 bucket
awsS3:bucket:list	List all S3 buckets in the account

Folder Operations

Action	Description
awsS3:folder:create	Create a folder (prefix) in a bucket
awsS3:folder:delete	Delete a folder and its contents
awsS3:folder:list	List folders under a prefix

---

awsS3:file:upload

Uploads a file to the specified S3 bucket and key.

Parameters

Parameter	Type	Required	Description
bucket	string	Yes	S3 bucket name
key	string	Yes	Object key (path) in the bucket
content	string	Yes	Base64-encoded file content
contentType	string	No	MIME type (e.g., application/json). Auto-detected if omitted
storageClass	string	No	S3 storage class: STANDARD, STANDARD_IA, GLACIER, etc. Defaults to STANDARD
metadata	object	No	Custom metadata key-value pairs

awsS3:file:download

Downloads a file from S3. The content is returned as a base64-encoded string.

Parameters

Parameter	Type	Required	Description
bucket	string	Yes	S3 bucket name
key	string	Yes	Object key to download

awsS3:file:delete

Deletes an object from an S3 bucket.

Parameters

Parameter	Type	Required	Description
bucket	string	Yes	S3 bucket name
key	string	Yes	Object key to delete

awsS3:file:list

Lists objects in a bucket, optionally filtered by prefix.

Parameters

Parameter	Type	Required	Description
bucket	string	Yes	S3 bucket name
prefix	string	No	Filter by key prefix (e.g., 2025/06/)
maxKeys	integer	No	Maximum number of keys to return. Defaults to 1000

awsS3:bucket:create

Creates a new S3 bucket.

Parameters

Parameter	Type	Required	Description
bucket	string	Yes	Globally unique bucket name
region	string	No	AWS region. Defaults to the connection's default region

awsS3:bucket:delete

Deletes an S3 bucket. The bucket must be empty.

Parameters

Parameter	Type	Required	Description
bucket	string	Yes	Bucket name to delete

awsS3:bucket:list

Lists all S3 buckets in the AWS account.

awsS3:folder:create

Creates a folder (zero-byte object with trailing slash) in a bucket.

Parameters

Parameter	Type	Required	Description
bucket	string	Yes	S3 bucket name
folderPath	string	Yes	Folder path (e.g., reports/2025/q2/)

awsS3:folder:delete

Deletes a folder and all objects under it.

Parameters

Parameter	Type	Required	Description
bucket	string	Yes	S3 bucket name
folderPath	string	Yes	Folder path to delete

awsS3:folder:list

Lists immediate subfolders (common prefixes) under a path.

Parameters

Parameter	Type	Required	Description
bucket	string	Yes	S3 bucket name
folderPath	string	No	Parent folder path. Defaults to root

Connection

Requires an AWS connection configured in the Global Configurator:

Field	Description
accessKeyId	AWS access key ID
secretAccessKey	AWS secret access key
region	Default AWS region (e.g., us-east-1)
sessionToken	Temporary session token (optional, for assumed roles)

Configure under Connections > AWS in the Global Configurator.

Output

file:upload

file:download

file:list

bucket:list