Worktables icon

Worktables

Interact with Monday.com boards and items

Actions26

Update → Upload

AI-generated

Overview

This node integrates with Monday.com to manage updates on items within boards. Specifically, the Update - Upload operation allows users to upload files to an update associated with a particular item on a Monday.com board.

Typical use cases include:

  • Attaching documents, images, or other files to updates for project tasks or items.
  • Automating file uploads as part of workflows that track progress or communication on Monday.com items.
  • Enhancing collaboration by programmatically adding relevant files to updates without manual intervention.

For example, you might use this node to automatically upload a generated report or image to an update on a task item whenever a certain event occurs in your workflow.

Properties

Name Meaning
Board Name or ID Select the Monday board where the item exists. You can choose from a list or specify an ID via expression. This is required.
Item Name or ID Select the specific item within the chosen board to which the update belongs. Choose from a list or specify an ID via expression. This is required.

Note: The provided properties JSON only includes these two inputs relevant to the "Update - Upload" operation.

Output

The node outputs a JSON object representing the response from the Monday.com API after attempting the file upload to the update. The structure typically contains details about the uploaded file or confirmation of the upload action.

If the node supports binary data input (file content), it uses the binary property specified by the user to read the file data to upload.

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 at https://api.monday.com/v2.
  • The user must provide valid board and item IDs accessible with the given API key.
  • The input binary data (file) must be available in the specified binary property.

Troubleshooting

  • API Key Not Found: If the API key credential is missing or invalid, the node will throw an error. Ensure the API key is correctly configured in n8n credentials.
  • Board or Item ID Missing: Both board and item identifiers are required. Errors occur if these are not provided or invalid.
  • Binary Property Undefined: If the specified binary property does not exist or contains no data, the node throws an error indicating no valid file data found.
  • Unsupported Operation: Using an operation other than "uploadFile" under the Update resource will cause an unsupported operation error.
  • File Upload Failures: Network issues or permission errors on Monday.com may cause upload failures. Check API permissions and network connectivity.

Links and References

Additional Notes from Source Code Analysis

  • The node uses the Monday.com GraphQL API to perform mutations and queries.
  • For uploading files to an update, the node expects binary data input and constructs a multipart/form-data request including the file.
  • The mutation used for uploading files to an update is named add_file_to_update with variables for the file and update ID.
  • The node requires the update ID to be known; however, since the user requested specifically the "Update - Upload" operation, the relevant parameters are the board ID and item ID to identify the context.
  • The code snippet for the upload operation shows it retrieves the binary file from the input data using the user-specified binary property name.

This summary focuses on the "Update" resource with the "Upload" operation as requested.

Discussion