Actions25
Folder → Update
AI-generatedOverview
This node updates an existing folder within a specified workspace and board in the Infinity platform. It allows users to modify folder properties such as the folder name, parent folder (to move or nest the folder), color, sort order, attribute IDs, and settings. This operation is useful for organizing and managing folder structures dynamically in workflows, for example, renaming a project folder, changing its color for better visual identification, or moving it under a different parent folder.
Use Case Examples
- Updating the name of a folder to reflect a new project phase.
- Changing the color of a folder to indicate priority status.
- Moving a folder into a different parent folder to reorganize the folder hierarchy.
Properties
| Name | Meaning |
|---|---|
| Workspace ID | The ID of the workspace where the folder exists. Required to identify the workspace context for the folder update. |
| Board ID | The ID of the board within the workspace where the folder exists. Required to specify the board context for the folder update. |
| Folder ID | The ID of the folder to update. This identifies the specific folder to be modified. |
| Folder Name | The new name for the folder. If left empty, the existing folder name remains unchanged. |
| Parent Folder | The ID of the parent folder to move this folder into, allowing nesting or reorganization of folders. Optional. |
| Folder Fields | Additional folder properties to update, including attribute IDs (JSON array), color (HEX format), settings (JSON object), and sort order (string). These fields allow detailed customization of the folder's appearance and behavior. |
Output
JSON
json- The updated folder object returned from the Infinity API, containing the folder's current properties after the update.
Dependencies
- Requires an API key credential for the Infinity platform to authenticate API requests.
Troubleshooting
- Error 'Set at least one folder field to update.' occurs if no folder fields are provided for update. Ensure at least one field such as folder name, parent folder, or folder fields is set.
- Invalid JSON errors may occur if the attribute IDs or settings fields contain malformed JSON. Validate JSON format before input.
- API errors may occur if workspace ID, board ID, or folder ID are incorrect or do not exist. Verify these IDs are correct and accessible.