Worktables

Interact with Monday.com boards and items

Actions26

Overview

This node allows users to interact with items on Monday.com boards, specifically supporting the deletion of an item or subitem from a board. It is useful in automation workflows where you need to programmatically remove tasks, issues, or entries from project boards based on certain triggers or conditions.

For example, you might use this node to automatically delete completed or obsolete tasks from a project board, or to clean up subitems when their parent item is removed.

Properties

Name	Meaning
Workspace Name or ID	Select the workspace containing the board. You can choose from a list or specify an ID via expression.
Board Name or ID	Select the Monday board from which the item will be deleted. Choose from the list or specify an ID via expression.
Is Subitem	Boolean flag indicating whether the target is a subitem (true) or a regular item (false).
Item Name or ID	Select the item to delete from the selected board. Required if "Is Subitem" is false.
Parent Item Name or ID	If deleting a subitem, select the parent item. Required if "Is Subitem" is true.
Subitem Name or ID	If deleting a subitem, select the specific subitem to delete.

Output

The output JSON contains the response from the Monday.com API after attempting to delete the specified item or subitem. Typically, it includes the ID of the deleted item confirming successful deletion, for example:

{
  "data": {
    "delete_item": {
      "id": "123456"
    }
  }
}

No binary data output is involved in this operation.

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 permissions on the API token are necessary to delete items/subitems on the specified board.

Troubleshooting

API Key Not Found: The node throws an error if the API key credential is missing or invalid. Ensure the API key is correctly configured in n8n credentials.
Item ID Required: If neither an item ID nor a subitem ID is provided (depending on the "Is Subitem" flag), the node will throw an error indicating that the item ID is required.
Permission Errors: Deletion may fail if the API token does not have sufficient permissions on the board or workspace.
Invalid IDs: Providing incorrect or non-existent board, item, or subitem IDs will result in errors from the Monday.com API.
Network Issues: Connectivity problems to the Monday.com API endpoint will cause request failures.

To resolve these:

Verify API key validity and permissions.
Double-check all IDs used in the node parameters.
Confirm network connectivity.
Review Monday.com API limits and restrictions.