Actions26
- Board Actions
- Item Actions
- Update Actions
- Team Actions
- Query Actions
Overview
The node "Worktables" integrates with Monday.com to manage and interact with boards and their related entities such as groups, items, updates, teams, and users. Specifically for the Board resource and the List Boards operation, it retrieves a list of boards within a specified workspace, filtered and ordered according to user preferences.
This operation is useful when you want to:
- Retrieve all or specific types of boards (public, private, shareable) from a workspace.
- Filter boards by their state (active, archived, deleted).
- Control the order in which boards are returned (by creation date, last used, or no particular order).
- Limit the number of boards retrieved for performance or pagination purposes.
Practical example:
You might use this node to fetch all active public boards in a given workspace, ordered by the most recently used, to display them in a dashboard or to automate workflows based on board data.
Properties
| Name | Meaning |
|---|---|
| Workspace Name or ID | Select the workspace from which to list boards. Can be chosen from a dropdown or specified via expression. This is required. |
| Board Kind | Filter boards by kind. Options: All, Public, Private, Shareable. Defaults to "All". |
| Order By | The order in which to retrieve boards. Options: None, Name (created_at), Newest (used_at). Default is None. The ordering is descending. |
| State | Filter boards by their state. Options: All, Active, Archived, Deleted. Default is Active. |
| Limit | Maximum number of boards to return. Minimum is 1. If set to 0, all boards will be returned. Default is 50. |
Output
The output is an array of JSON objects, each representing a board with the following fields:
name: The name of the board.value: The board's unique identifier.boardKind: The kind of the board (public, private, shareable).state: The current state of the board (active, archived, deleted).description: Description text of the board.itemsCount: Number of items on the board.creator: Object containing the creator's id and name.owners: Array of owners with their ids and names.subscribers: Array of subscribers with their ids and names.tags: Array of tags associated with the board.workspaceId: The ID of the workspace the board belongs to.updatedAt: Timestamp of the last update.url: URL link to the board.
This detailed information allows downstream nodes or workflows to utilize comprehensive board metadata.
Dependencies
- Requires an API key credential for Monday.com API access.
- The node makes HTTP POST requests to the Monday.com GraphQL API endpoint at
https://api.monday.com/v2. - Proper configuration of the API key credential in n8n is necessary for authentication.
Troubleshooting
- API Key not found error: Occurs if the API key credential is missing or invalid. Ensure that the API key is correctly configured in n8n credentials.
- Board ID or Workspace ID required errors: These happen if mandatory parameters are not provided. Always specify the workspace when listing boards.
- Empty results: Could be due to filters like board kind or state excluding all boards. Try broadening filter criteria.
- Rate limits or API errors: Monday.com may throttle requests; handle retries or reduce request frequency accordingly.