Work with Amazon S3 Files in an Agentic Workflow
Upload Kizen files to Amazon Simple Storage Service, copy files and file content, and create presigned upload and download links, all automatically and in real time.
Audience: Admins, Developers, Solution Architects
Purpose: Describes six new action steps in Kizen's Agentic Workflow builder for working with live Amazon S3 data
Overview
Caution: This setup reflects Kizen's default configuration. Your administrator may have customized your layout, so columns or navigation may appear differently. Trial accounts may have limited features.
Once you configure the connection between Amazon Simple Storage Service (S3) and Kizen through the Amazon S3 integration, you can work with live S3 data in Agentic Workflows.
Before You Begin
To work with Amazon S3 files in an Agentic Workflow, you need an active S3 connection in Kizen. See Set Up Amazon S3 in Kizen for details.
Work with Amazon S3 Files an Agentic Workflow
To work with Amazon S3 files in an Agentic Workflow:
Choose the action to perform
In the Action Settings section of the Add Action modal, select the Action dropdown menu, and do one of the following:
To write a Kizen file to an Amazon S3 bucket, select Upload File.
To create an identical Kizen file from an S3 file, select Get File Content.
To return details about an S3 file, select Get File Metadata.
To return a list of S3 files by folder, select List Files.
To create a server-side copy of an S3 file, select Copy File.
To create an upload or download URL for Amazon S3, select Generate Presigned URL.
Then, to set up the action, specify the source and destination for each input and output field. For detailed descriptions of these inputs and outputs, see the sections for each individual action below.
Set Up an Upload File Action
The Upload File action writes a file in Kizen to Amazon S3.
To set up an Upload File action:
Configure the sources for the script inputs
For each of the fields in the Script Inputs section of the Add Action modal, select the source of the field's value from the Input Source dropdown menu, and then configure the source with the additional controls that appear.
The fields are as follows:
Bucket
String
The destination Amazon S3 bucket.
Yes
Connection Secret Tag
String
The name of the Amazon S3 environment from your integration secret on which to perform the operation.
Yes
File
UUID
The UUID of the Kizen file to upload.
Yes
Content Type
String
The MIME type of the file to upload.
No
Object Key
String
The full object key of the Kizen file on Amazon S3, including the path and the file name, like this: loans/2026/statement.pdf.
Yes
Fail If Exists
Boolean
Whether the upload should fail if the file to upload already exists at this location.
No
SSE-KMS Key ID
String
The KMS key ID or ARN to use to encrypt the file.
No
Storage Class
String
The API name of the uploaded file's storage class. The bucket's default storage class is the default value of this field.
No
Configure the destinations for the script outputs
For each of the fields in the Script Outputs section of the modal, select the destination of the field's value from the Output Destination dropdown menu, and then configure the destination with the additional controls that appear.
The fields are as follows:
Destination Key
String
The uploaded Kizen file's Amazon S3 key.
No
ETag
String
The uploaded Kizen file's ETag.
No
Size
Number
The size of the uploaded Kizen file in bytes.
No
Version ID
String
The version ID of the uploaded Kizen file. This field has a value only when the Amazon S3 bucket uses versioning.
No
Set Up a Get File Content Action
The Get File Content action creates a byte-for-byte copy of an Amazon S3 file in Kizen. The file must be no larger than 250 MB, or the action fails.
To set up a Get File Content action:
Configure the sources for the script inputs
For each of the fields in the Script Inputs section of the Add Action modal, select the source of the field's value from the Input Source dropdown menu, and then configure the source with the additional controls that appear.
The fields are as follows:
Bucket
String
The Amazon S3 bucket of the target file.
Yes
Connection Secret Tag
String
The name of the Amazon S3 environment from your integration secret on which to perform the operation.
Yes
Object Key
String
The full object key of the target file on Amazon S3, including the path and the file name, like this: loans/2026/statement.pdf.
Yes
Version ID
String
The version ID of the target file on Amazon S3. Supply a value for this field only when the file's bucket uses versioning.
No
Configure the destinations for the script outputs
For each of the fields in the Script Outputs section of the modal, select the destination of the field's value from the Output Destination dropdown menu, and then configure the destination with the additional controls that appear.
The fields are as follows:
Content Type
String
The source file's MIME type
No
ETag
String
The source file's Etag
No
File
UUID
The UUID of the new Kizen file
No
Last Modified
DateTime
The date and time when the source object was last modified
No
Size
Number
The size of the source file in bytes
No
Set Up a Get File Metadata Action
The Get File Metadata action returns the existence status, size, content type, last-modified time, and storage class of the specified Amazon S3 file without downloading the file.
To set up a Get File Metadata action:
Configure the sources for the script inputs
For each of the fields in the Script Inputs section of the Add Action modal, select the source of the field's value from the Input Source dropdown menu, and then configure the source with the additional controls that appear.
The fields are as follows:
Bucket
String
The Amazon S3 bucket of the target file.
Yes
Connection Secret Tag
String
The name of the Amazon S3 environment from your integration secret on which to perform the operation.
Yes
Object Key
String
The full object key of the target file on Amazon S3, including the path and the file name, like this: loans/2026/statement.pdf.
Yes
Configure the destinations for the script outputs
For each of the fields in the Script Outputs section of the modal, select the destination of the field's value from the Output Destination dropdown menu, and then configure the destination with the additional controls that appear.
The fields are as follows:
Content Type
String
The target file's MIME type
No
ETag
String
The target file's ETag
No
Exists
Boolean
Whether the target file exists
No
Last Modified
DateTime
The date and time when the target file was last modified
No
Size
Number
The size of the target file in bytes
No
Storage Class
String
The Amazon S3 storage class of the target file
No
Set Up a List Files Action
The List Files action returns a list of all the files in the specified folder. You can optionally filter the results by name or modified date and group the results by subfolder.
To set up a List Files action:
Configure the sources for the script inputs
For each of the fields in the Script Inputs section of the Add Action modal, select the source of the field's value from the Input Source dropdown menu, and then configure the source with the additional controls that appear.
The fields are as follows:
Bucket
String
The Amazon S3 bucket of the target files.
Yes
Connection Secret Tag
String
The name of the Amazon S3 environment from your integration secret on which to perform the operation.
Yes
Delimiter
String
The character or characters by which to separate subfolders when the Group by Folder input is yes. Specify a value for this field only when the files in your bucket use a delimiter other than /.
No
Fetch All Pages
Boolean
Whether to return up to 100 pages of results as a single output (yes) or return one page per call (no).
No
Folder
String
The Amazon S3 prefix to target, like loans/2026.
No
Group by Folder
Boolean
Whether to group files that share a subfolder within the target folder.
No
Max Results
Number
The maximum number of files to return, from 1 to 1,000. The default value is 1000.
No
Modified After
DateTime
A filter to return only those files modified after the specified date and time.
No
Name Contains
String
A filter to return only those files whose file names contain the specified string.
No
Page Token
String
The value of the Next Page Token field from the previous output of the List Files action. Pass this value to retrieve the next set of up to 100 files.
No
Configure the destinations for the script outputs
For each of the fields in the Script Outputs section of the modal, select the destination of the field's value from the Output Destination dropdown menu, and then configure the destination with the additional controls that appear.
The fields are as follows:
File Count
Number
The number of listed files on the current page of results.
No
File Objects
String
A stringified JSON array of the listed files.
No
Next Page Token
String
A token that signifies there is at least one more page of up to 100 listed files to return. Pass this value in the Page Token input field of a subsequent List Files action.
No
Sub-Folders
String
A stringified JSON array of the listed files on the current page of results grouped by subfolder. This field has a value only when you set the Group by Folder input to yes.
No
Set Up a Copy File Action
The Copy File action creates a copy of an Amazon S3 file elsewhere on Amazon S3. The destination can be a different bucket or even a different S3 environment.
To set up a Copy File action:
Configure the sources for the script inputs
For each of the fields in the Script Inputs section of the Add Action modal, select the source of the field's value from the Input Source dropdown menu, and then configure the source with the additional controls that appear.
The fields are as follows:
Source Bucket
String
The Amazon S3 bucket of the original file.
Yes
Destination Bucket
String
The Amazon S3 bucket for the copied file.
No
Source Connection Secret Tag
String
The name of the Amazon S3 environment from your integration secret where the original file resides.
Yes
Destination Connection Secret Tag
String
The name of the Amazon S3 environment from your integration secret in which to place the copied file.
Yes
Source Object Key
String
The full object key of the original file on Amazon S3, including the path and the file name, like this: loans/2026/statement.pdf.
Yes
Destination Object Key
String
The full object key of the copied file on Amazon S3, including the path and the file name, like this: loans/2026/statement.pdf.
Yes
Configure the destinations for the script outputs
For each of the fields in the Script Outputs section of the modal, select the destination of the field's value from the Output Destination dropdown menu, and then configure the destination with the additional controls that appear.
The fields are as follows:
Destination Key
String
The Amazon S3 object key of the copied file
No
ETag
String
The original file's ETag
No
Last Modified
DateTime
The date and time when the original file was last modified
No
Set Up a Generate Presigned URL Action
The Generate Presigned URL action creates a temporary presigned upload or download URL for moving files to and from Amazon S3.
To set up a Generate Presigned URL action:
Configure the sources for the script inputs
For each of the fields in the Script Inputs section of the Add Action modal, select the source of the field's value from the Input Source dropdown menu, and then configure the source with the additional controls that appear.
The fields are as follows:
Bucket
String
The Amazon S3 bucket to use for the upload or download.
Yes
Connection Secret Tag
String
The name of the target Amazon S3 environment from your integration secret.
Yes
Expires In
Number
The lifespan of the link in seconds. The maximum value is 604800, the same as 7 days. Exceeding the maximum causes the step to fail.
Yes
Object Key
String
The full object key of the file, including the path and the file name, like this: loans/2026/statement.pdf. For an upload operation, the integration uploads the file to this location under this file name. For a download operation, this is the location and file name of the file to download.
Yes
Operation
String
The operation to perform. For an upload link, set the value to put. For a download link, set the value to get.
Yes
Configure the destinations for the script outputs
For each of the fields in the Script Outputs section of the modal, select the destination of the field's value from the Output Destination dropdown menu, and then configure the destination with the additional controls that appear.
The fields are as follows:
Expires At
DateTime
The date and time when the presigned URL expires
No
URL
String
The presigned upload or download URL
No
What's Next
Continue to Troubleshoot Amazon S3 to find solutions to common issues with the Amazon S3 integration.
Amazon Web Services, AWS, Amazon Simple Storage Service, and Amazon S3 are trademarks of Amazon.com, Inc. or its affiliates. Kizen's Amazon S3 integration is not affiliated with, sponsored by, or endorsed by Amazon.com, Inc.
Last updated
Was this helpful?