Skip to content
Try for free
On this page

Integrations

S3

Upload, download, list, and manage S3 files and buckets

Use Amazon S3 to manage objects and buckets from a workflow. Upload, download, copy, or delete objects, inspect metadata, and create time-limited presigned URLs. Configure an AWS access key and secret access key.

Use the block

Upload, download, copy, and delete objects (individually or in batches), inspect object metadata, generate time-limited presigned URLs, list bucket contents, and create, list, or delete buckets. Requires AWS access key and secret access key.

Actions

S3 Put Object

Upload a file to an AWS S3 bucket

Inputs and outputs

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringYesAWS region (e.g., us-east-1)
bucketNamestringYesS3 bucket name (e.g., my-bucket)
objectKeystringYesObject key/path in S3 (e.g., folder/filename.ext)
filefileNoFile to upload
contentstringNoText content to upload (alternative to file)
contentTypestringNoContent-Type header (auto-detected from file if not provided)
aclstringNoAccess control list (e.g., private, public-read)

Output

ParameterTypeDescription
urlstringURL of the uploaded S3 object
uristringS3 URI of the uploaded object (s3://bucket/key)
metadataobjectUpload metadata including ETag and location

S3 Get Object

Retrieve an object from an AWS S3 bucket

Inputs and outputs

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringNoOptional region override when URL does not include region (e.g., us-east-1, eu-west-1)
s3UristringYesS3 Object URL (e.g., https://bucket.s3.region.amazonaws.com/path/to/file)

Output

ParameterTypeDescription
urlstringPre-signed URL for downloading the S3 object
filefileDownloaded file stored in execution files
metadataobjectFile metadata including type, size, name, and last modified date

S3 List Objects

List objects in an AWS S3 bucket

Inputs and outputs

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringYesAWS region (e.g., us-east-1)
bucketNamestringYesS3 bucket name (e.g., my-bucket)
prefixstringNoPrefix to filter objects (e.g., folder/, images/2024/)
maxKeysnumberNoMaximum number of objects to return (default: 1000)
continuationTokenstringNoToken for pagination from previous list response

Output

ParameterTypeDescription
objectsarrayList of S3 objects
↳ keystringObject key
↳ sizenumberObject size in bytes
↳ lastModifiedstringLast modified timestamp
↳ etagstringEntity tag
metadataobjectListing metadata including pagination info

S3 Delete Object

Delete an object from an AWS S3 bucket

Inputs and outputs

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringYesAWS region (e.g., us-east-1)
bucketNamestringYesS3 bucket name (e.g., my-bucket)
objectKeystringYesObject key/path to delete (e.g., folder/file.txt)

Output

ParameterTypeDescription
deletedbooleanWhether the object was successfully deleted
metadataobjectDeletion metadata

S3 Copy Object

Copy an object within or between AWS S3 buckets

Inputs and outputs

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringYesAWS region (e.g., us-east-1)
sourceBucketstringYesSource bucket name (e.g., my-bucket)
sourceKeystringYesSource object key/path (e.g., folder/file.txt)
destinationBucketstringYesDestination bucket name (e.g., my-other-bucket)
destinationKeystringYesDestination object key/path (e.g., backup/file.txt)
aclstringNoAccess control list for the copied object (e.g., private, public-read)

Output

ParameterTypeDescription
urlstringURL of the copied S3 object
uristringS3 URI of the copied object (s3://bucket/key)
metadataobjectCopy operation metadata

S3 List Buckets

List the S3 buckets owned by the authenticated AWS account

Inputs and outputs

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringYesAWS region to address the request to (e.g., us-east-1)
prefixstringNoLimit the response to bucket names that begin with this prefix
maxBucketsnumberNoMaximum number of buckets to return (1-10000)
continuationTokenstringNoToken for pagination from a previous list buckets response

Output

ParameterTypeDescription
bucketsarrayList of S3 buckets owned by the account
↳ namestringBucket name
↳ creationDatestringBucket creation timestamp
↳ regionstringAWS region where the bucket is located
metadataobjectListing metadata including owner and pagination info

S3 Head Object

Retrieve metadata for an S3 object without downloading its body

Inputs and outputs

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringYesAWS region (e.g., us-east-1)
bucketNamestringYesS3 bucket name (e.g., my-bucket)
objectKeystringYesObject key/path to inspect (e.g., folder/file.txt)
versionIdstringNoSpecific object version ID to inspect (for versioned buckets)

Output

ParameterTypeDescription
existsbooleanWhether the object exists and was reachable
metadataobjectObject metadata including size, content type, ETag, and last modified date

S3 Create Bucket

Create a new AWS S3 bucket in the specified region

Inputs and outputs

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringYesAWS region to create the bucket in (e.g., us-east-1)
bucketNamestringYesName for the new S3 bucket (must be globally unique)
aclstringNoCanned ACL for the bucket (e.g., private, public-read)

Output

ParameterTypeDescription
metadataobjectCreated bucket metadata including name and location

S3 Delete Bucket

Delete an empty AWS S3 bucket

Inputs and outputs

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringYesAWS region where the bucket is located (e.g., us-east-1)
bucketNamestringYesName of the S3 bucket to delete (must be empty)

Output

ParameterTypeDescription
deletedbooleanWhether the bucket was successfully deleted
metadataobjectDeletion metadata including bucket name

S3 Presigned URL

Generate a time-limited presigned URL to download or upload an S3 object

Inputs and outputs

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringYesAWS region where the bucket is located (e.g., us-east-1)
bucketNamestringYesS3 bucket name (e.g., my-bucket)
objectKeystringYesObject key/path for the presigned URL (e.g., folder/file.txt)
methodstringYesOperation the URL grants: get (download) or put (upload)
expiresInnumberNoURL validity in seconds (1-604800, default 3600)
contentTypestringNoContent-Type the upload must use (only applies to put URLs)

Output

ParameterTypeDescription
urlstringThe generated presigned URL
metadataobjectPresigned URL metadata including method and expiration

S3 Delete Objects

Delete multiple objects from an AWS S3 bucket in a single batch request

Inputs and outputs

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringYesAWS region (e.g., us-east-1)
bucketNamestringYesS3 bucket name (e.g., my-bucket)
keysjsonYesArray of object keys to delete (e.g., ["a.txt", "folder/b.txt"]). Max 1000.
quietbooleanNoReturn only deletion errors, omitting successfully deleted keys

Output

ParameterTypeDescription
deletedarrayObjects that were successfully deleted
↳ keystringDeleted object key
↳ versionIdstringVersion ID of the deleted object
↳ deleteMarkerbooleanWhether a delete marker was created
errorsarrayObjects that failed to delete
↳ keystringObject key that failed
↳ codestringError code
↳ messagestringError message
metadataobjectBatch deletion summary including counts
Was this helpful?
Suggest an edit