ZIP Extract

Description

Extracts the contents of a ZIP file into a temporary server folder. Returns an array with complete information for each extracted file (path, download URL, extension, size). Compatible with ZIP Create output, HTTP downloads, or any node that generates a ZIP file.

Configuration

Field	Type	Required	Description
zipPath	text	No	Path to the ZIP file. If empty, uses data.filePath from previous node
outputFolder	text	No	Name of the extraction subfolder. If empty, generates automatic unique name
filterExtensions	text	No	Only extract files with these extensions, comma-separated (e.g. .csv,.txt). If empty, extracts everything

Output

{
  "files": [
    {
      "filename": "report.csv",
      "filePath": "/www/wwwroot/floogos/engine_us1/temporal/cli_123/unzip-1712345678/report.csv",
      "urlPath": "https://us1.floogos.com/download/cli_123/unzip-1712345678/report.csv",
      "relativePath": "report.csv",
      "extension": ".csv",
      "size_bytes": 15230
    },
    {
      "filename": "data.json",
      "filePath": "/www/wwwroot/floogos/engine_us1/temporal/cli_123/unzip-1712345678/data.json",
      "urlPath": "https://us1.floogos.com/download/cli_123/unzip-1712345678/data.json",
      "relativePath": "data.json",
      "extension": ".json",
      "size_bytes": 8420
    }
  ],
  "total_extracted": 2,
  "total_skipped": 0,
  "output_dir": "/www/wwwroot/floogos/engine_us1/temporal/cli_123/unzip-1712345678",
  "source_zip": "/www/wwwroot/floogos/engine_us1/temporal/cli_123/archive-1712345678.zip"
}

Usage Examples

Extract ZIP from previous node

ZIP Create → ZIP Extract

{
  "outputFolder": "my-files"
}

Extract only CSV and TXT from a ZIP

{
  "zipPath": "{{filePath}}",
  "filterExtensions": ".csv,.txt",
  "outputFolder": "imported-data"
}

Extract and process each file

HTTP Request (download ZIP) → ZIP Extract → Iterator (files) → CSV Parse

Notes

• ZIP directory structure is preserved as subfolders within the extraction folder
• File names are sanitized to prevent path traversal (../)
• If filterExtensions is configured, non-matching files are reported in total_skipped
• Each extracted file has its own urlPath for direct download
• The relativePath field preserves the original ZIP folder structure
• Files are stored in temporal/cli_{client_id}/ on the server

Related Nodes

• ZIP Create - Compress files into ZIP
• CSV Parse - Parse an extracted CSV
• CSV Create - Create CSV/TXT file