list_flows
Retrieve and browse Langflow flows with pagination and folder filtering to discover workflows and manage collections.
Instructions
List Langflow flows with flexible filtering and pagination.
Purpose: Retrieve flows from your Langflow instance with optional pagination and organization filters. Essential for discovering available workflows, managing large flow collections, and browsing flows within specific folders.
Parameters:
page (optional, number, default: 1, min: 1): Page number for pagination
size (optional, number, default: 50, max: 100): Number of flows per page
folder_id (optional, UUID string): Filter flows within a specific folder
components_only (optional, boolean, default: false): Return only component flows (reusable flow components)
get_all (optional, boolean, default: true): Retrieve all flows ignoring pagination (use with caution for large datasets)
Returns: Array of FlowRead objects containing:
id (UUID): Unique flow identifier
name (string): Flow display name
description (string): Flow purpose description
folder_id (UUID): Parent folder if organized
user_id (UUID): Owner user identifier
created_at, updated_at (ISO timestamps): Flow lifecycle dates
data (object): Flow configuration with nodes, edges, and component definitions
Usage Examples:
List recent flows (default): {}
Paginate through flows: { page: 2, size: 20 }
Flows in specific folder: { folder_id: "uuid-here" }
Get all component flows: { components_only: true, get_all: true }
Best Practices:
Use pagination (page/size) for better performance instead of get_all
Filter by folder_id when working within organized projects
Keep page size <= 50 for optimal response times
Cache folder_id values to reduce API calls
Use get_all sparingly, only when you need complete dataset
Common Errors:
"Page size cannot exceed 100": Reduce size parameter to 100 or less
"Invalid folder ID format": Ensure folder_id is a valid UUID (use list_folders to get valid IDs)
Empty results: Check if folder_id exists or try removing filters
Connection timeout: Reduce page size or enable pagination instead of get_all
Related Tools:
create_flow: Create new flows after listing existing ones
get_flow: Retrieve complete flow details by ID from this list
list_folders: Find valid folder_id values for filtering
update_flow: Modify flows found in this list
delete_flow: Remove flows identified in this list
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination (default: 1) | |
| size | No | Number of items per page (default: 50, max: 100) | |
| get_all | No | Get all flows without pagination (default: true) | |
| folder_id | No | Filter by folder ID | |
| components_only | No | Return only components (default: false) |