Worktables

Overview

The node "Worktables" integrates with Monday.com via its API, enabling automation workflows to interact with Monday.com boards, items, updates, teams, users, and queries. Specifically for the Update resource with the List operation, the node retrieves all updates associated with a specified item on a Monday.com board.

This is useful in scenarios where you want to monitor or process communication threads, comments, or status updates related to specific tasks or items within Monday.com. For example, you might use this node to fetch all updates on a task to analyze team feedback or trigger further actions based on update content.

Properties

These properties are used to identify the exact context (workspace, board, item) from which to retrieve updates.

Output

The output JSON contains an array of updates for the specified item. Each update includes:

• id: The unique identifier of the update.
• text_body: The textual content of the update.
• created_at: Timestamp when the update was created.
• updated_at: Timestamp when the update was last modified.
• creator: Object with creator details (id and name).
• assets: Array of attached assets/files with fields like name, public_url, and file_size.
• replies: Array of replies to the update, each with text_body, created_at, and creator's name.
• pinned_to_top: Information if the update is pinned, including item_id.

This structured data allows downstream nodes or processes to analyze or act upon the updates and their metadata.

Dependencies

• Requires an API key credential for Monday.com (referred generically as an API authentication token).
• The node makes HTTP POST requests to the Monday.com GraphQL API endpoint: https://api.monday.com/v2.
• Proper configuration of the API key credential in n8n is necessary for authentication.

Troubleshooting

• API Key Not Found: If the API key credential is missing or invalid, the node will throw an error indicating the absence of the API key. Ensure the credential is correctly set up.
• Missing Required Parameters: The node requires valid workspace, board, and item IDs. Omitting these or providing invalid values will cause errors.
• Unsupported Operation or Resource: Using operations or resources not supported by the node will result in errors.
• Rate Limits or API Errors: Monday.com API rate limits or other API errors may cause failures; check API usage and error messages.
• Empty Updates List: If no updates exist for the specified item, the output will be an empty array.

Links and References

• Monday.com API Documentation
• n8n Expressions Documentation
• Monday.com Updates API Reference

This summary focuses on the Update resource with the List operation as requested, describing how the node fetches updates for a given item in Monday.com.