Storage

Most data in a flow lives only as long as the run: a step produces it, later steps use it, and it's gone when the run ends. Storage is for data that needs to last longer, such as a file a flow should read every time, or a value one run saves for the next.

Open Storage in the sidebar. It has two tabs:

Tab	Holds
Files	Files that flows and agents can use, such as documents, templates and generated reports.
Shared Variables	Small values that every flow in the workspace can read and update, such as a counter or the time of the last sync.

Everything in Storage belongs to the workspace, so every flow in the workspace can use it.

Files

The Files tab lists each file with its name, type, size, status and File ID. To add one, click Upload, choose the file, and give it a name, a category and optional purposes.

Flows work with files in two places:

• Storage keeps a file until you delete it.
• A run's working area holds files while a run is in progress. Steps such as Convert to File and Extract from File read and write files here by name. The working area is cleared automatically after the run.

These nodes move files between the two, or create them:

Node	Action	What it does
File Storage	Upload File	Saves a file from the run's working area, or content such as text or JSON, to Storage.
	Download File	Copies a file from Storage into the run's working area, using its File ID.
	List Files	Lists files in Storage, optionally by type, extension or flow.
	Get File Detail	Gets a file's details from its File ID.
	Delete File	Deletes a file from Storage permanently.
Convert to File	Save as CSV, JSON, HTML, text or binary	Creates a file in the run's working area from data.
Extract from File	Extract File to JSON or Text, Parse CSV to JSON	Reads a file in the run's working area and outputs its contents.
PDF	Generate PDF	Builds a PDF from an HTML template and saves it to Storage.

For example, to read a CSV that you uploaded to Storage: File Storage › Download File with the file's File ID, then Extract from File › Parse CSV to JSON with the downloaded file name. To keep a report that a flow builds: Convert to File › Save as CSV, then File Storage › Upload File.

Shared variables

A shared variable is a named value, such as last_sync or processed_count, that any flow in the workspace can read and update. Flows save and read them with the Variables node. The Shared Variables tab shows them all.

The Variables node

The Variables node has two Scope Type settings:

Scope Type	Values last	Visible to
Within flow (default)	Until the current run ends.	Only steps in the same run.
Shared (all flows)	Until deleted, or until Expire after (seconds) passes.	Every flow in the workspace, and the Shared Variables tab.

Its actions save and read values by key:

Action	Use it to
Set Value / Set Multiple Values	Save one or several values.
Get Value / Get Multiple Values	Read one or several values.
Push Value Onto List / Pop Value From List	Add to or take from a list, for example a simple queue.
Remove Value / Remove All Values	Delete values.

You can't put a variable straight into a field. Read it with a Get Value step first, then reference that step's output, such as Get last sync.value. See Using data from earlier steps. If the key doesn't exist, Get Value succeeds with an empty value unless you turn off Success If Not Exist.

Managing shared variables

In the Shared Variables tab you can:

• See each variable's key, value, type, expiry and when it was last updated.
• Search by the start of the key, and filter by type.
• Click New variable to add one by hand. A value is any JSON: text in quotes ("hello"), a number, true or false, null, a list or an object. An Expiry is optional.
• Edit or Delete a variable. Flows that read a deleted variable no longer find it.
• Import legacy variables to bring in values saved before shared variables belonged to a workspace.

Limits

Limit	Value
Size of one value	1 MB
Items in one list	1,000
Shared variables per organization	10,000
Total size per organization	100 MB

Related

• Share values between flows
• File Storage node and Variables node