飞书Install

Summary

Lists files in a Feishu cloud drive folder, with optional filtering, sorting, pagination, and recursive traversal of subfolders.

Inputs

• authentication — Choose user-level OAuth2 or app-level credentials; app-level credentials are the default.
• folder_token — Folder token to list. Leave blank to list the user's cloud drive root; root listings do not support pagination.
• type_filter — Filter by file type: all, spreadsheet, bitable, legacy document, new document, mind map, file, folder, or shortcut. Defaults to all.
• order_by — Sort by edit time or creation time. Defaults to edit time.
• direction — Sort ascending or descending; defaults to descending.
• user_id_type — User ID format: Open ID, Union ID, or User ID. Defaults to Open ID.
• returnAll — Return all available results or stop at the configured limit. Defaults to false.
• limit — Maximum results when Return All is disabled; defaults to 50, with a supported range of 1–200.
• recursive — Also list files in subfolders. Defaults to false.
• recursiveDepth — Maximum recursive depth when recursion is enabled. Defaults to 2; 0 means traverse all levels.
• dataStructure — When recursion is enabled, return a flat list or a tree structure. Defaults to flat.
• options — Optional recursive request concurrency (default 5, range 1–10), rate limit in requests per second (default 5; API limit stated as 20), and request timeout in milliseconds (default 0, meaning no timeout).

Output shape

A list of n8n items containing the matching file or folder records.

The operation's source implementation is not included in the source pack, so exact record fields and whether each record is emitted as a separate item cannot be confirmed. Root-folder listings do not support pagination; recursive traversal and flat/tree output apply only when enabled.

Links

• n8n community nodes installation guide