File

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, or append content to existing files.

Actions

`file_read`

Input

Parameter	Type	Required	Description

Output

Parameter	Type	Description
`files`	file[]	Workspace file objects (read) or fetched file objects (fetch)
`contents`	array	Array of file text contents, one entry per file (get content)
`combinedContent`	string	All fetched file contents merged into a single text string (fetch)
`id`	string	File ID (write and append)
`name`	string	File name (write and append)
`size`	number	File size in bytes (write and append)
`url`	string	URL to access the file (write and append)

`file_get_content`

Input

Parameter	Type	Required	Description

Output

Parameter	Type	Description
`files`	file[]	Workspace file objects (read) or fetched file objects (fetch)
`contents`	array	Array of file text contents, one entry per file (get content)
`combinedContent`	string	All fetched file contents merged into a single text string (fetch)
`id`	string	File ID (write and append)
`name`	string	File name (write and append)
`size`	number	File size in bytes (write and append)
`url`	string	URL to access the file (write and append)

`file_fetch`

Input

Parameter	Type	Required	Description

Output

Parameter	Type	Description
`files`	file[]	Workspace file objects (read) or fetched file objects (fetch)
`contents`	array	Array of file text contents, one entry per file (get content)
`combinedContent`	string	All fetched file contents merged into a single text string (fetch)
`id`	string	File ID (write and append)
`name`	string	File name (write and append)
`size`	number	File size in bytes (write and append)
`url`	string	URL to access the file (write and append)

`file_write`

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

Input

Parameter	Type	Required	Description
`fileName`	string	Yes	File name (e.g., "data.csv"). If a file with this name exists, a numeric suffix is added automatically.
`content`	string	Yes	The text content to write to the file.
`contentType`	string	No	MIME type for new files (e.g., "text/plain"). Auto-detected from file extension if omitted.

Output

Parameter	Type	Description
`id`	string	File ID
`name`	string	File name
`size`	number	File size in bytes
`url`	string	URL to access the file

`file_append`

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

Input

Parameter	Type	Required	Description
`fileName`	string	Yes	Name of an existing workspace file to append to.
`content`	string	Yes	The text content to append to the file.

Output

Parameter	Type	Description
`id`	string	File ID
`name`	string	File name
`size`	number	File size in bytes
`url`	string	URL to access the file

On this page