create_folder
Create folders in Langflow to organize flows with optional nested hierarchy for project-based workflow management.
Instructions
Create a new folder for organizing flows with optional nested hierarchy.
Purpose: Establish organizational structure in Langflow by creating folders to group related flows. Supports hierarchical organization through nested folders, enabling project-based or team-based flow management. Essential for maintaining organized workspace with many flows.
Parameters:
name (required, string, max: 255 chars): Folder display name (should be descriptive and unique)
description (optional, string): Purpose and contents description for documentation
parent_id (optional, UUID string): Parent folder ID for creating nested subfolder hierarchy (use list_folders to find valid parent IDs)
Returns: FolderRead object containing:
id (UUID): Newly created folder's unique identifier (use this as folder_id when creating/organizing flows)
name (string): Folder display name
description (string): Folder description
parent_id (UUID): Parent folder ID if nested, null for root-level folder
created_at, updated_at (ISO timestamps): Folder lifecycle timestamps
Usage Examples:
Create root folder: { name: "Production Flows" }
Folder with description: { name: "Customer Services", description: "Customer-facing automation workflows" }
Create nested subfolder: { name: "API Integrations", parent_id: "parent-folder-uuid" }
Project organization: { name: "Q1 2024 Project", description: "First quarter automation initiatives" }
Best Practices:
Use descriptive, hierarchical names (e.g., "Marketing/Email Campaigns" structure via nesting)
Add descriptions to document folder purpose and ownership
Plan folder hierarchy before creation (root categories, then subcategories)
Create folders before flows to enable immediate organization
Use consistent naming conventions across team (e.g., "Team - Project - Category")
Limit nesting depth to 2-3 levels for maintainability
Cache created folder IDs for subsequent flow creation operations
Common Errors:
"Folder name already exists": Choose unique name or create in different parent folder
"Invalid parent folder ID": Ensure parent_id is valid UUID from list_folders
"Parent folder not found": parent_id doesn't exist or was deleted
"Name is required": Must provide name parameter
"Maximum nesting depth exceeded": Too many nested levels (flatten hierarchy)
"Circular reference detected": parent_id creates loop in folder structure
Related Tools:
list_folders: Browse existing folders before creating new ones
update_folder: Modify folder name, description, or move to different parent
create_flow: Create flows organized within this folder using returned ID
get_folder: Retrieve folder details after creation
delete_folder: Remove folder when no longer needed
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Folder name (required) | |
| parent_id | No | Optional parent folder ID (UUID) for nested folders | |
| description | No | Optional folder description |