File

The File block is a built-in Zoen block for working with files stored in the workspace, or fetched from external URLs. It handles reading, writing, appending, compressing, decompressing, and sharing files as part of a workflow.

With the File block, you can:

• Read and extract content: Load workspace file objects and extract their text content
• Fetch from URLs: Retrieve and parse files from external URLs with custom headers
• Write and append: Create new workspace files or append content to existing ones
• Compress and decompress: Bundle files into a .zip archive or extract an archive into the workspace
• Manage sharing: Enable or disable a public share link for a file, with public, password, email, or SSO access modes

In Zoen, the File block allows your agents to read and extract text from workspace files, fetch and parse files from URLs, write or append content to files, bundle files into or out of .zip archives, and control public sharing access for a file—all programmatically as steps in a workflow. This makes it possible to move file content into and out of a workflow, package outputs for download or transfer, and expose files to external users through a managed share link.

Usage Instructions

Read workspace file objects, extract the text content of files, fetch and parse files from URLs with optional headers, write new workspace files, append content to existing files, compress files into a .zip archive, extract a .zip archive into the workspace, or manage the public share link for a file.

Actions

file_read

Input

Output

file_get_content

Extract the text content of one or more workspace files from selected file objects or canonical workspace file IDs.

Input

Output

file_fetch

Fetch and parse a file from a URL with optional custom headers.

Input

Output

file_write

Create a new workspace file. If a file with the same name already exists, a numeric suffix is added (e.g., "data (1).csv").

Input

Output

file_append

Append content to an existing workspace file. The file must already exist. Content is added to the end of the file.

Input

Output

file_compress

Compress one or more workspace files into a single .zip archive stored in the workspace, for bundling files to download, transfer, or store.

Input

Output

file_decompress

Extract the contents of a .zip archive into the workspace, preserving the archive folder structure.

Input

Output

file_manage_sharing

Enable or disable the public share link for a workspace file, and set its access mode (public, password, email, or SSO). Idempotent: the public link stays stable across changes.

Input

Output