Overview
This node interacts with the "Item" resource of a project management platform's API, allowing users to perform various operations on items within boards. It supports creating new items, updating existing ones, retrieving single or multiple items, deleting items, and reading formula column values from items.
Common scenarios include:
- Automating task creation on specific boards.
- Updating item details programmatically based on external triggers.
- Fetching item data for reporting or integration purposes.
- Deleting obsolete or completed items automatically.
- Extracting computed formula results from items for further processing.
For example, you could use this node to create a new task on a project board whenever a form is submitted, update the status of an item when a related event occurs, or retrieve all items from a board to generate a summary report.
Properties
| Name | Meaning |
|---|---|
| Board | The board to work with. This is a required option that lets you select which board the item operations will target. |
(Note: The provided properties JSON only includes the "Board" property for the "item" resource.)
Output
The node outputs an array of JSON objects representing the results of the performed operations:
- For create operation: Outputs the newly created item's full data as returned by the API.
- For update operation: Outputs the updated item columns' data.
- For get operation: Outputs the single requested item's data.
- For getAll operation: Outputs multiple items' data, each as a separate JSON object.
- For delete operation: Outputs a success flag and the deleted item's ID.
- For readFormula operation: Outputs simplified objects containing item IDs, names, and formula column values in the selected format (value, text, or both).
If the node encounters errors and is set to continue on failure, it outputs error messages paired with the corresponding input item index.
The node does not output binary data.
Dependencies
- Requires an API authentication token credential to connect to the Monday.com API.
- Uses the Monday.com API client internally to perform operations.
- No additional environment variables are needed beyond the API credential.
- The node depends on internal utility methods to build column values either in simple or advanced mode.
Troubleshooting
Common issues:
- Invalid or expired API token causing authentication failures.
- Incorrect board or item IDs leading to "not found" errors.
- Malformed JSON in advanced column values input causing parsing errors.
- Exceeding API rate limits resulting in temporary request failures.
Error messages:
"error": "<message>"in output JSON indicates an operation failure on a specific item.- NodeOperationError thrown if not continuing on fail, usually with descriptive message about the failure cause.
Resolutions:
- Verify and refresh API credentials.
- Double-check board and item identifiers.
- Validate JSON syntax for advanced inputs.
- Implement retry logic or reduce request frequency if hitting rate limits.