Monday.com icon

Monday.com

Interact with Monday.com API
Join our community

Actions26

Overview

This node operation updates an existing folder in Monday.com. It allows users to modify the folder's name and/or its color. This is useful for organizing projects or workspaces by renaming folders to reflect new priorities or statuses, and by changing folder colors to visually categorize or highlight them.

Practical examples:

  • Renaming a project folder after a rebranding or scope change.
  • Changing the folder color to indicate progress status, e.g., from "Working Orange" to "Done Green".
  • Updating multiple folders programmatically as part of a workflow automation that manages workspace organization.

Properties

Name Meaning
Folder ID The unique identifier of the folder to update. Required to specify which folder to modify.
Folder Name The new name for the folder. Optional; if left empty, the folder name remains unchanged.
Folder Color The color to assign to the folder. Options include: Default, Done Green, Bright Green, Working Orange, Dark Orange, Sunset, Stuck Red, Dark Red, Sofia Pink, Lipstick, Purple, Dark Purple, Indigo, Bright Blue, Aquamarine, Chill Blue.

Output

The output JSON contains the updated folder object returned from the Monday.com API. This typically includes the folder's ID, updated name, color, and other metadata as provided by the API response.

Example output structure (simplified):

{
  "id": "12345",
  "name": "New Folder Name",
  "color": "DONE_GREEN",
  // ... other folder properties
}

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 in credentials.
  • The node depends on the Monday.com API client utility bundled with the node implementation.

Troubleshooting

  • Common issues:

    • Invalid or missing Folder ID will cause the update to fail.
    • Providing an invalid color value not listed in the options may result in an error.
    • Network or authentication errors if the API token is incorrect or expired.

  • Error messages:

    • "Folder ID is required": Ensure the Folder ID property is set.
    • "Unauthorized" or "Invalid API token": Verify the API key credential is valid and has necessary permissions.
    • "Folder not found": Confirm the Folder ID exists in the Monday.com account.

  • Resolution tips:

    • Double-check input parameters for correctness.
    • Refresh or re-enter API credentials.
    • Test the folder ID manually via Monday.com UI or API to confirm existence.

Links and References

Discussion