4.5.1 Upload Files to Storage

Upload one or more files into the local storage of MicroTx Workflows. These files are used for processing later by the File tool and by tasks, such as GenAI Ingestion tasks and Agentic Planner tasks.

The file storage is configured when MicroTx is installed based on the information provided in the values.yaml file. See File System Storage Properties in MicroTx Installation and Configuration Guide.

Ensure that the MicroTx Workflows runtime user has read and write permissions on this folder.

Upload limits and restrictions

• Multipart upload limit is 32 MB by default.
• Path traversal is blocked; files cannot be stored outside the configured storage file path.
• Upload all types of files as no file-type or extension whitelist is enforced during upload.
• If you use the REST API call to upload files to storage, POST /api/storage/upload, you must specify the server context path, such as /workflow-server/api/storage/upload.

To upload files to storage:

1. Open the navigation menu and click Connectors.
2. Click Storage.

   All files available in storage are displayed in a table.

3. Click .
   The Upload Files dialog box appears.
4. Select the files that you want to upload from your computer in one of the following ways:
   • Drag one or more files from your computer and drop them into the Drag and drop files here or click to browse box.
   • Click inside the Drag and drop files here or click to browse box. A file picker window opens. Navigate to and select one or more files that you want to upload.
5. Ensure that the file names that you have selected are listed.
6. Select Overwrite existing files to replace any existing files in the local storage with the latest uploaded files that have the same name.
   By default this option is not selected. Files are uploaded to storage with the same name. By default, if a file with the same name already exists in the storage, that file is not uploaded.
7. Click Upload to upload the selected files to storage.

Files are uploaded to storage with the same name. If a file with the same name already exists in the storage, that file is overwritten if you select Overwrite existing files. By default, if a file with the same name already exists in the storage, that file is not uploaded.

After you upload the files to storage, you can use the uploaded files in tasks. The following sample code demonstrates how you can use pdfreference1.4.pdf, an uploaded file, in a GenAI Ingestion task.

{
      "name": "genai_ingestion",
      "taskReferenceName": "genai_ingestion_ref",
  	  "inputParameters":  
      {
		....
        "data": 
		{
          "source": "local",
          "filePath": "pdfreference1.4.pdf"
        }
		....
      }
}