Monday.com icon

Monday.com

Interact with Monday.com API

Actions6

Overview

This node operation updates an existing item on a Monday.com board. It allows users to modify column values of a specified item by either providing raw JSON data or using a simplified dynamic UI mode that presents specific column types for easier input.

Common scenarios include:

  • Automating status updates on tasks or projects.
  • Changing dropdown selections or assigning people to items.
  • Updating timeline dates or linking related items across boards.
  • Bulk updating multiple columns programmatically via JSON.

Practical example:

  • Automatically mark a task as "Done" and assign it to a team member when a certain condition is met in your workflow.
  • Update multiple columns such as status, priority, and due date for a project item based on external triggers.

Properties

Name Meaning
Column Input Mode How to input column values:
- Advanced (JSON): Enter column values as a JSON object.
- Simple (Dynamic UI): Select values using dedicated UI fields for each column type.
Board The Monday.com board where the item exists and will be updated.
Item ID The unique identifier of the item to update.
Column Values (JSON) (Advanced mode only) JSON object representing the column values to update. Example: {"status": {"label": "Done"}, "text": "Hello"}
Status Column (Simple mode only) Select a status column to update.
Status Value (Simple mode only) Select the new status value for the chosen status column.
Dropdown Column (Simple mode only) Select a dropdown column to update.
Dropdown Values (Simple mode only) Select one or more dropdown options to set for the dropdown column.
People Column (Simple mode only) Select a people column to update.
People (Simple mode only) Select users or guests to assign in the people column.
Board Relation Column (Simple mode only) Select a board relation column to update.
Related Items (Simple mode only) Select linked items from the related board to associate with this item.
Timeline Column (Simple mode only) Select a timeline column to update.
Timeline Start Date (Simple mode only) Set the start date for the timeline column.
Timeline End Date (Simple mode only) Set the end date for the timeline column.
File Upload Notice Information notice explaining that file uploads require uploading files to an external storage service first and then referencing their public URLs in advanced JSON mode.

Output

The output is an array of JSON objects representing the updated item(s). For the update operation, the JSON typically contains the response from Monday.com's API reflecting the updated item's details, including its columns and values.

Example output structure:

{
  "id": "12345",
  "name": "Item Name",
  "column_values": {
    "status": { "label": "Done" },
    "text": "Updated text",
    ...
  }
}

No binary data output is produced by this operation.

Dependencies

  • Requires an API authentication token credential for Monday.com.
  • Uses Monday.com API version defaulting to "2023-10" unless overridden.
  • Relies on Monday.com boards and columns being pre-configured.
  • For simple mode, dynamic loading of boards, columns, statuses, dropdowns, people, and linked items is used to populate UI options.
  • File uploads are not handled directly; users must upload files externally and reference URLs in JSON.

Troubleshooting

  • Invalid Item ID: If the provided item ID does not exist on the selected board, the API will return an error. Verify the item ID is correct and belongs to the specified board.
  • Malformed JSON in Advanced Mode: When entering column values as JSON, syntax errors or invalid structures will cause failures. Use a JSON validator before input.
  • Missing Required Fields: Ensure all required properties like Board and Item ID are set.
  • File Upload Issues: Attempting to upload files via simple mode will not work. Follow the instructions in the notice to upload files externally and use advanced JSON mode.
  • API Rate Limits: Frequent updates may hit Monday.com API rate limits. Implement delays or batch processing if needed.
  • Permission Errors: The API token used must have sufficient permissions to update items on the target board.

Links and References

Discussion