Worktables icon

Worktables

Interact with Monday.com boards and items

Actions26

Update → List

AI-generated

Overview

The node "Worktables" integrates with Monday.com, enabling interaction with various Monday.com resources such as boards, items, updates, teams, and users via the Monday.com API. Specifically for the Update resource with the List operation, this node retrieves all updates associated with a specified item on a Monday.com board.

This functionality is useful when you want to programmatically fetch all communication or progress updates related to a particular task or item in Monday.com. For example, you might use it to gather all comments and attachments posted on a task to analyze team collaboration or to trigger further automation based on update content.

Properties

Name Meaning
Workspace Name or ID Select the workspace containing the board. Can be chosen from a list or specified by expression. (Required for many operations but not directly for Update List)
Board Name or ID Select the Monday.com board containing the item. Can be chosen from a list or specified by expression. (Required for many operations but not directly for Update List)
Item Name or ID Select the specific item whose updates you want to list. Can be chosen from a list or specified by expression. (Required)
Operation The action to perform on the resource. For Update resource, options include List, Create, Update, Delete, Pin, Duplicate, Upload, Download. Here, "List" means retrieving all updates of an item.

Note: The provided properties JSON includes several properties for other resources and operations; for the Update resource's List operation, the key property is Item Name or ID.

Output

The output is a JSON array containing the updates of the specified item. Each update object 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: An object with the creator's id and name.
  • assets: Array of attached files/assets, each with 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 rich structure allows detailed inspection of all communications and attachments related to the item.

Dependencies

  • Requires an API key credential for Monday.com with appropriate permissions to access workspaces, boards, items, and updates.
  • The node makes HTTP POST requests to the Monday.com GraphQL API endpoint at https://api.monday.com/v2.
  • No additional external dependencies beyond the Monday.com API and n8n's built-in HTTP request helper.

Troubleshooting

  • API Key Not Found: If the API key credential is missing or invalid, the node will throw an error. Ensure the API key is correctly configured in n8n credentials.
  • Invalid Item ID: Providing an incorrect or non-existent item ID will result in empty or error responses. Verify the item ID exists in the selected board.
  • Permission Errors: Insufficient permissions on the API key may cause authorization errors. Confirm the API key has read access to the relevant workspace and boards.
  • Empty Updates: If no updates exist for the item, the returned array will be empty. This is expected behavior.
  • Malformed Query: Since the query is constructed internally, this is unlikely unless the input parameters are invalid or missing.

Links and References

If you need details about other operations or resources, please specify!

Discussion