File Storage
Manage files between EFS execution storage and persistent File Storage Service with automatic cleanup
Actions
Steps this node can perform. Add one from Add a step, then pick the action.
Upload File
Upload file from EFS path or data content to persistent File Storage Service
Settings
| Field | Type | Required | Description |
|---|---|---|---|
| Binary File Mode | Yes / No | If true, upload from EFS file by name. If false, upload from data content Default: true | |
| EFS File Name | Text | Name of the file in EFS to upload (required when binaryFile is true) | |
| File Storage Name | Text | File Storage name for FileStorage Service (with extension). Optional - defaults to EFS File Name or auto-generated | |
| File Content | Code | The data content to upload - can be string, array, object, number, etc. (required when binaryFile is false unless allowEmptyContent is enabled) | |
| Accept Empty Content | Yes / No | Allow creating an empty file when content is not provided. Useful for flows that legitimately produce empty output without requiring placeholder content. Default: false | |
| Description | Text | Optional file description for documentation | |
| Tags | List | Tags for categorization and search (comma-separated) |
Output
No documented output fields.
Download File
Download file from File Storage Service to EFS temporary storage
Settings
| Field | Type | Required | Description |
|---|---|---|---|
| File Storage ID | Text | Yes | File Storage ID from File Storage Service (from upload action or list action) |
| Filename | Text | Custom filename in EFS (defaults to original filename) | |
| Overwrite if Exists | Yes / No | Overwrite if file already exists in EFS Default: false |
Output
Later steps use this data by picking this step in the $ picker. For example, fileName is $.<step ID>.output.fileName.
{
"fileName": "string",
"filePath": "string",
"mimeType": "string",
"size": 0
}Example values show the shape of the data, not real values. See Using data from earlier steps.
Field descriptions
| Field | Type | Description |
|---|---|---|
fileName | Text | Filename in EFS |
filePath | Text | Full path to downloaded file in EFS |
mimeType | Text | File MIME type |
size | Number | File size in bytes |
List Files
List files in File Storage Service with optional filters
Settings
| Field | Type | Required | Description |
|---|---|---|---|
| Filter Type | Choice | Type of filter to apply Options: All files, By MIME type, By extension, By flowDefault: all | |
| MIME Type | Text | Filter by MIME type (e.g., application/pdf, image/png) | |
| Extension | Text | Filter by file extension (without dot, e.g., pdf, txt, json) | |
| Flow ID | Text | Filter by flow ID to get files from specific flow | |
| Limit | Number | Maximum number of files to return per page (1-1000) Default: 50 | |
| Page | Number | Page number for pagination (0 = first page, 1 = second page, etc.) Default: 0 |
Output
Later steps use this data by picking this step in the $ picker. For example, files[0] is $.<step ID>.output.files[0].
{
"files": [
{}
],
"limit": 0,
"offset": 0,
"success": false,
"total": 0
}Example values show the shape of the data, not real values. See Using data from earlier steps.
Field descriptions
| Field | Type | Description |
|---|---|---|
files[] | List | Array of file objects |
limit | Number | Limit used in query |
offset | Number | Offset used in query |
success | Yes / No | Whether the operation was successful |
total | Number | Total number of files matching filter |
Get File Detail
Get detailed information about a specific file
Settings
| Field | Type | Required | Description |
|---|---|---|---|
| File ID | Text | Yes | File ID from File Storage Service |
Output
Later steps use this data by picking this step in the $ picker. For example, description is $.<step ID>.output.description.
{
"description": "string",
"tags": [
"string"
]
}Example values show the shape of the data, not real values. See Using data from earlier steps.
Field descriptions
| Field | Type | Description |
|---|---|---|
description | Text | File description |
tags[] | List | File tags |
Delete File
Permanently delete a file from File Storage Service
Settings
| Field | Type | Required | Description |
|---|---|---|---|
| File ID | Text | Yes | File ID to delete from File Storage Service |
Output
Later steps use this data by picking this step in the $ picker. For example, deletedAt is $.<step ID>.output.deletedAt.
{
"deletedAt": "string",
"fileId": "string",
"success": false
}Example values show the shape of the data, not real values. See Using data from earlier steps.
Field descriptions
| Field | Type | Description |
|---|---|---|
deletedAt | Text | Deletion timestamp (ISO 8601) |
fileId | Text | ID of the deleted file |
success | Yes / No | Whether deletion succeeded |