Infinity icon

Infinity

Work with Infinity items

Actions25

Folder → Create

AI-generated

Overview

This node operation creates a new folder within a specified board and workspace in the Infinity platform. It allows users to organize their boards by adding folders, optionally setting a parent folder to create subfolders, and customizing folder properties such as name, color, attribute IDs, settings, and sort order. This operation is useful for managing project organization, categorizing tasks, or grouping related items within a board.

Use Case Examples

  1. Creating a new folder named 'Marketing Campaign' in a project board to organize related tasks and items.
  2. Adding a subfolder under an existing folder to further categorize items within a board.
  3. Setting folder color and attributes to visually distinguish folders and customize their behavior.

Properties

Name Meaning
Workspace ID The ID of the workspace where the folder will be created. This is required to specify the workspace context.
Board ID The ID of the board within the workspace where the folder will be created. This is required to specify the board context.
Folder Name The name of the folder to create. This is a required field to identify the folder.
Parent Folder Optional ID of the parent folder to create a subfolder or move the folder into an existing folder.
Folder Fields Additional optional fields to customize the folder, including attribute IDs (JSON array), color (HEX format), settings (JSON object), and sort order.

Output

JSON

  • json
    • id - The unique identifier of the created folder.
    • name - The name of the created folder.
    • parent_id - The ID of the parent folder if the folder is a subfolder.
    • color - The color of the folder in HEX format.
    • attribute_ids - Array of attribute IDs associated with the folder.
    • settings - Settings object of the folder.
    • sort_order - Sort order of the folder.

Dependencies

  • Requires an API key credential for authentication with the Infinity API.

Troubleshooting

  • Ensure that the Workspace ID and Board ID are correctly specified and exist in the Infinity platform.
  • Folder Name is required; an error will be thrown if it is missing when creating a folder.
  • The JSON fields for attribute IDs and settings must be valid JSON; invalid JSON will cause errors.
  • If the parent folder ID is specified, ensure it exists within the specified board and workspace.

Discussion