> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Folder Contents

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`

<Note>
  External Documentation

  To learn more, visit the [Lark documentation](https://open.larksuite.com/document/server-docs/docs/drive-v1/folder/list).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter        | Description                                                                                                                                                                                                                                                                |
  | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Folder Token     | The token of the folder to list contents from.<br /><br />This value can be obtained from folder URLs in the format: `https://sample.larksuite.com/drive/folder/{folder_token}`<br /><br />Alternatively, use `GetRootFolderMetadata` action to get the root folder token. |
  | Page Size        | Number of items to return per page (`1`-`200`).                                                                                                                                                                                                                            |
  | Page Token       | A token used for pagination. This value can be obtained from the `page_token` property from a previous response.                                                                                                                                                           |
  | Return All Pages | Automatically fetch all resources, page by page.                                                                                                                                                                                                                           |
</div>

## Example Output

```json theme={"dark"}
{
	"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](https://library.blinkops.com/workflows/list-folder-contents-with-lark-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-folder-contents-with-lark-and-send-results-via-email/canvas" />
</div>