Worktables icon

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 a task when it is marked as completed in another system, or to clean up test data after a workflow finishes.

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 parent item (false).
Item Name or ID Select the item to delete if Is Subitem is false. Choose from the list or specify an ID via expression. Required if not deleting a subitem.
Parent Item Name or ID If deleting a subitem (Is Subitem is true), select the parent item. Choose from the list or specify an ID via expression.
Subitem Name or ID If deleting a subitem (Is Subitem is true), select the subitem to delete. Choose from the list or specify an ID via expression.

Output

The output JSON contains the result of the deletion mutation from the Monday.com API. Typically, it returns the ID of the deleted item confirming successful deletion, for example:

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

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for Monday.com (referred generically as "an API key credential").
  • The node makes HTTP POST requests to the Monday.com GraphQL API endpoint at https://api.monday.com/v2.
  • Proper permissions on the API key are necessary to delete items 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 set correctly in the node credentials.
  • Item ID Required: If neither an item ID nor a subitem ID is provided when attempting deletion, the node will throw an error stating that the item ID is required.
  • Invalid Board or Workspace: Selecting a non-existent or unauthorized workspace or board may cause errors. Verify that the workspace and board IDs are correct and accessible with the API key.
  • Permission Denied: The API key must have sufficient permissions to delete items. Lack of permission will result in API errors.
  • Subitem Deletion: When deleting a subitem, ensure both the parent item ID and subitem ID are correctly specified; otherwise, the deletion will fail.

Links and References

Discussion