get_flow
Retrieve complete details and configuration of a specific flow, including node graph, component configurations, and metadata, for inspection or debugging.
Instructions
Retrieve complete details and configuration of a specific flow.
Purpose: Fetch comprehensive information about a flow including its full node graph, component configurations, connections, and metadata. Essential for inspecting flow structure, debugging workflows, and preparing flows for modification or execution.
Parameters:
flow_id (required, UUID string): The unique identifier of the flow to retrieve (obtained from list_flows or create_flow)
Returns: FlowRead object containing:
id (UUID): Flow's unique identifier
name (string): Flow display name
description (string): Flow purpose description
folder_id (UUID): Parent folder identifier if organized
user_id (UUID): Owner user identifier
created_at, updated_at (ISO timestamps): Flow lifecycle timestamps
data (object): Complete flow structure including:
nodes (array): All component nodes with their configurations
edges (array): Connections between nodes
viewport (object): Canvas positioning data
description (string): Flow-level documentation
Usage Examples:
Get flow details: { flow_id: "550e8400-e29b-41d4-a716-446655440000" }
Inspect before modification: { flow_id: "flow-uuid-from-list" }
Debug flow structure: { flow_id: "failing-flow-uuid" }
Best Practices:
Use list_flows first to discover available flow_id values
Cache flow data locally to reduce API calls when repeatedly accessing same flow
Check updated_at timestamp to detect if flow changed since last retrieval
Inspect data.nodes to understand flow's component structure
Review data.edges to trace data flow between components
Validate flow_id format (must be valid UUID) before making request
Common Errors:
"Flow not found": flow_id doesn't exist or was deleted (verify with list_flows)
"Invalid UUID format": flow_id must be valid UUID string (e.g., "550e8400-e29b-41d4-a716-446655440000")
"Unauthorized": API key lacks permission to access this flow
"Flow ID is required": Must provide flow_id parameter
Connection timeout: Check Langflow instance availability and network connectivity
Related Tools:
list_flows: Find available flow_id values
update_flow: Modify flow configuration after retrieval
run_flow: Execute flow after inspecting its structure
build_flow: Compile and validate flow structure
delete_flow: Remove flow after inspection confirms it's no longer needed
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flow_id | Yes | The ID of the flow to retrieve |