Lark Calendar icon

Lark Calendar

Lark Calendar Management

Actions32

Overview

The node "Lark Calendar" provides integration with the Lark Suite calendar service, allowing users to manage calendar-related data. Specifically, the "Obtain The Acl" operation under the "Acl" resource retrieves the Access Control List (ACL) for a specified calendar. This is useful when you want to check who has what permissions on a particular calendar within Lark Suite.

Common scenarios include:

  • Auditing calendar permissions to ensure correct access levels.
  • Synchronizing calendar ACLs with other systems.
  • Displaying or managing user access rights programmatically.

Example: You have a shared team calendar and want to list all users who can view or edit it, along with their permission levels.

Properties

Name Meaning
Authentication Method of authentication to use. Options: Tenant Token, OAuth2
Calendar Id The unique identifier of the calendar whose ACL you want to obtain.
Options Additional optional settings:
- Use Custom Body Whether to send a custom request body instead of the default one (boolean).

Output

The node outputs JSON data representing the Access Control List of the specified calendar. This typically includes details about each user or group with access, such as their role or permission level on the calendar.

If binary data were involved (not indicated here), it would be summarized accordingly, but this operation deals purely with JSON ACL information.

Dependencies

  • Requires an API key credential or OAuth2 token for authenticating with the Lark Suite Open APIs.
  • The base URL for API requests is https://open.larksuite.com/open-apis.
  • Proper configuration of credentials in n8n is necessary to authorize requests.

Troubleshooting

  • Missing or invalid Calendar Id: Ensure the Calendar Id is correctly provided and corresponds to an existing calendar.
  • Authentication errors: Verify that the selected authentication method is properly configured and the credentials are valid.
  • Permission denied: The authenticated user or token might not have sufficient rights to read the ACL of the calendar.
  • API rate limits or network issues: Check connectivity and API usage quotas.

Error messages will generally indicate if the problem is due to authentication failure, missing parameters, or insufficient permissions. Resolving these involves checking credentials, input values, and user roles.

Links and References

Discussion