Skip to main content
List files and folders within a specific folder in Lark Drive. One of the following scopes is required for using this action:
  • View, comment, edit, and manage all files in My Space
  • View the metadata of files in My Space
External DocumentationTo learn more, visit the Lark documentation.

​
Parameters

ParameterDescription
Folder TokenThe token of the folder to list contents from.

This value can be obtained from folder URLs in the format: https://sample.larksuite.com/drive/folder/{folder_token}

Alternatively, use GetRootFolderMetadata action to get the root folder token.
Page SizeNumber of items to return per page (1-200).
Page TokenA token used for pagination. This value can be obtained from the page_token property from a previous response.
Return All PagesAutomatically fetch all resources, page by page.

​
Example Output

{
	"code": 0,
	"data": {
		"files": [
			{
				"name": "test pdf.pdf",
				"parent_token": "fldbcO1UuPz8VwnpPx5a9abcef",
				"token": "boxbc0dGSMu23m7QkC1bvabcef",
				"type": "file",
				"url": "https://larksuite.com/file/boxbc0dGSMu23m7QkC1bvabcef"
			},
			{
				"name": "test file.docx",
				"parent_token": "fldcnCEG903UUB4fUqfysdabcef",
				"shortcut_info": {
					"target_token": "boxcnRPaXpD4I6Je9t8k8babcef",
					"target_type": "file"
				},
				"token": "nodcnVkiLQ6LD4CsUEaANrabcef",
				"type": "shortcut",
				"url": "https://larksuite.com/file/boxcnRPaXpD4I6Je9t8k8babcef"
			},
			{
				"name": "test docx",
				"parent_token": "fldcnCEG903UUB4fUqfysdabcef",
				"token": "doxcntan34DX4QoKJu7jJyabcef",
				"type": "docx",
				"url": "https://larksuite.com/docx/doxcntan34DX4QoKJu7jJyabcef"
			},
			{
				"name": "test sheet",
				"parent_token": "fldcnCEG903UUB4fUqfysdabcef",
				"token": "shtcnOko1Ad0HU48HH8KHuabcef",
				"type": "sheet",
				"url": "https://larksuite.com/sheets/shtcnOko1Ad0HU48HH8KHuabcef"
			}
		],
		"has_more": false
	},
	"msg": "success"
}

​
Workflow Library Example

List Folder Contents with Lark and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop