List Files

List workspace files, optionally filtered by name.

Type

file.list

Block Tool File

Folderfile

Channels

Any

Pipe

Value

Scope

Any

List Files returns workspace files for this workspace. Expired files are omitted unless Include expired is on. Soft-deleted files are never listed.

Copy an id into Get File or other File blocks.

Configure

Setting	Description
Name contains (optional)	Case-insensitive match on the display name
Page size	1–500. Default 50 if empty
Skip	Number of files to skip. Use `nextSkip` from a previous list
Include expired	Include files whose expiry time has already passed

Handles

Handle	Role
In (target)	Incoming connection
Out (source)	Continues after the list is loaded

Pipe schema

The next block reads this on the data pipe (pipe.value):

Key	Type	Description
`files`	list	File records (same shape as Get File)
`nextSkip`	number	Present when another page exists. Pass it as Skip

Use case

Show recent uploads, then send one with File output.
Find a file by name before Persist File or Delete File.