Actions28
- File Actions
- Multipart Upload File Actions
- Permission Member Actions
- Permissionpublic Actions
- Statistic Actions
- Media Actions
- Multipart Upload Media Actions
- Comment Actions
- Subscription Actions
- Document Import Actions
Overview
The node "Lark Files" provides integration with Lark's file management system, specifically enabling operations related to media files. The "Download A Material" operation allows users to download a specific media file from Lark by providing a valid file token. This is useful in scenarios where automated workflows need to retrieve and process files stored in Lark, such as downloading images, documents, or other media for further processing, archiving, or sharing.
Practical examples include:
- Automatically downloading an image uploaded to a Lark workspace for use in another application.
- Retrieving a document file to perform text extraction or analysis.
- Archiving media files from Lark into external storage systems.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authentication to access the Lark API. Options: Tenant Token, OAuth2. |
| File Token | The unique token identifying the file to be downloaded. Required to specify which media file to fetch. |
| Options | Additional optional settings for the download operation. Currently supports: Use Custom Body (boolean) - whether to send a custom request body. |
Output
The node outputs the downloaded media file data in the json output field. This typically includes metadata about the file and the file content itself if binary data handling is supported. Since this operation downloads media, the output may also contain binary data representing the actual file content, allowing subsequent nodes to process or save the file.
Dependencies
- Requires access to Lark's Open API endpoints at
https://open.larksuite.com/open-apis. - Requires either a Tenant Token or OAuth2 credentials configured in n8n to authenticate API requests.
- Proper permissions on the Lark account to access and download the specified file.
Troubleshooting
- Invalid or missing file token: Ensure the file token provided is correct and has not expired. Refer to Lark's documentation on how to obtain a valid file token.
- Authentication errors: Verify that the selected authentication method is correctly configured and the credentials are valid.
- Permission denied: The authenticated user or app might lack permission to access the requested file. Check Lark's permission settings.
- Network or API errors: Confirm network connectivity and that the Lark API service is operational.
Links and References
- Lark Files Management Overview (as referenced in the property description)
- Lark Open API Documentation