Inner Workflow¶
Class: InnerWorkflowBlockV1
Source: inference.core.workflows.core_steps.flow_control.inner_workflow.v1.InnerWorkflowBlockV1
Execute a nested workflow while mapping parent data into the child's inputs via parameter_bindings.
Provide either a full inline definition in workflow_definition, or resolve a saved workflow using
workflow_workspace_id and workflow_id (optional workflow_version_id).
Reference fields are expanded at compile time via workflows_core.inner_workflow_spec_resolver
(default: Roboflow API using workflows_core.api_key, or local definitions when workspace is
"local").
At compile time the engine validates composition (acyclicity, max depth) and parameter_bindings,
then inlines the child's steps into the parent workflow graph (same execution path as ordinary
steps).
The block's run() method is not used at runtime; do not call it directly.
Type identifier¶
Use the following identifier in step "type" field: roboflow_core/inner_workflow@v1to add the block as
as step in your workflow.
Properties¶
| Name | Type | Description | Refs |
|---|---|---|---|
name |
str |
Enter a unique identifier for this step.. | ❌ |
workflow_definition |
Dict[Any, Any] |
Full nested workflow definition (same JSON shape as a root workflow: version, inputs, steps, outputs). Required unless workflow_workspace_id and workflow_id are set; mutually exclusive with those reference fields.. |
❌ |
workflow_workspace_id |
str |
Workspace id for a saved workflow to load (Roboflow slug or "local" for on-disk definitions). Use with workflow_id; mutually exclusive with a non-empty workflow_definition.. |
❌ |
workflow_id |
str |
Saved workflow id to fetch. Use with workflow_workspace_id.. |
❌ |
workflow_version_id |
str |
Optional pinned workflow version when resolving by id.. | ❌ |
The Refs column marks possibility to parametrise the property with dynamic values available
in workflow runtime. See Bindings for more info.
Available Connections¶
Compatible Blocks
Check what blocks you can connect to Inner Workflow in version v1.
- inputs:
VLM As Classifier,Line Counter,MoonshotAI Kimi,Stability AI Image Generation,Path Deviation,Trace Visualization,Qwen2.5-VL,Image Stack,Anthropic Claude,Per-Class Confidence Filter,Icon Visualization,SIFT Comparison,Morphological Transformation,Color Visualization,SmolVLM2,LMM For Classification,Single-Label Classification Model,Perspective Correction,Clip Comparison,Corner Visualization,Environment Secrets Store,Roboflow Custom Metadata,Detections Merge,Halo Visualization,Dynamic Zone,Keypoint Detection Model,Qwen-VL,JSON Parser,Email Notification,Halo Visualization,Object Detection Model,Data Aggregator,Google Gemma,Background Color Visualization,Ellipse Visualization,Email Notification,Twilio SMS/MMS Notification,Text Display,Polygon Visualization,Crop Visualization,Absolute Static Crop,Image Preprocessing,Template Matching,Model Monitoring Inference Aggregator,Relative Static Crop,OpenRouter,OpenAI,PLC ModbusTCP,Florence-2 Model,VLM As Detector,Motion Detection,Heatmap Visualization,OCR Model,OpenAI,Detections Filter,Perception Encoder Embedding Model,Blur Visualization,Dimension Collapse,Barcode Detection,Depth Estimation,Instance Segmentation Model,Stability AI Outpainting,Anthropic Claude,YOLO-World Model,Google Gemini,Clip Comparison,Google Gemini,PLC EthernetIP,Background Subtraction,Buffer,Keypoint Visualization,CSV Formatter,Webhook Sink,Byte Tracker,Stitch Images,Florence-2 Model,Current Time,Detections List Roll-Up,Contrast Equalization,Mask Edge Snap,OpenAI,Qwen3-VL,Moondream2,Line Counter,VLM As Detector,Google Gemini,Triangle Visualization,Slack Notification,Overlap Filter,Time in Zone,Inner Workflow,CLIP Embedding Model,First Non Empty Or Default,Detections Stabilizer,SIFT,Local File Sink,Multi-Label Classification Model,Cosine Similarity,Image Contours,Keypoint Detection Model,VLM As Classifier,Pixel Color Count,GLM-OCR,Roboflow Asset Library Attributes,Image Slicer,Polygon Zone Visualization,Time in Zone,Google Gemma API,Semantic Segmentation Model,Stitch OCR Detections,Image Threshold,Line Counter Visualization,Distance Measurement,Semantic Segmentation Model,Multi-Label Classification Model,Contrast Enhancement,Camera Calibration,QR Code Generator,Detection Offset,ByteTrack Tracker,Expression,Detection Event Log,Detections Transformation,S3 Sink,Microsoft SQL Server Sink,Mask Area Measurement,Google Vision OCR,Twilio SMS Notification,Image Blur,Detections Combine,Morphological Transformation,Property Definition,Camera Focus,Delta Filter,Size Measurement,Roboflow Vision Events,Stability AI Inpainting,PTZ Tracking (ONVIF),Classification Label Visualization,Bounding Rectangle,SAM2 Video Tracker,Stitch OCR Detections,Event Writer,Grid Visualization,Qwen3.5-VL,Byte Tracker,Switch Case,Dominant Color,Rate Limiter,Mask Visualization,Llama 3.2 Vision,Reference Path Visualization,Velocity,Label Visualization,Identify Outliers,Image Slicer,SIFT Comparison,Byte Tracker,OPC UA Writer Sink,Dot Visualization,Cache Set,Identify Changes,Dynamic Crop,Detections Stitch,Circle Visualization,Path Deviation,BoT-SORT Tracker,SAM3 Video Tracker,Camera Focus,Llama 3.2 Vision,Gaze Detection,Segment Anything 2 Model,OpenAI-Compatible LLM,MoonshotAI Kimi,Single-Label Classification Model,Overlap Analysis,QR Code Detection,Qwen3.5,CogVLM,Object Detection Model,SAM 3 Interactive,Qwen 3.6 API,Detections Consensus,Bounding Box Visualization,Multi-Label Classification Model,LMM,OpenAI,SAM 3,PLC Reader,Image Convert Grayscale,Instance Segmentation Model,Continue If,Roboflow Visual Search,EasyOCR,Roboflow Dataset Upload,SAM 3,Cache Get,Detections Classes Replacement,Instance Segmentation Model,Pixelate Visualization,Keypoint Detection Model,Roboflow Dataset Upload,SORT Tracker,Instance Segmentation Model,PLC Writer,Track Class Lock,Qwen 3.5 API,Anthropic Claude,Object Detection Model,Time in Zone,MQTT Writer,Polygon Visualization,OC-SORT Tracker,SAM 3,Model Comparison Visualization,Single-Label Classification Model,Seg Preview - outputs:
VLM As Classifier,Line Counter,MoonshotAI Kimi,Stability AI Image Generation,Trace Visualization,Path Deviation,Qwen2.5-VL,Image Stack,Anthropic Claude,Per-Class Confidence Filter,Icon Visualization,SIFT Comparison,Morphological Transformation,Color Visualization,SmolVLM2,LMM For Classification,Single-Label Classification Model,Perspective Correction,Corner Visualization,Clip Comparison,Roboflow Custom Metadata,Detections Merge,Halo Visualization,Dynamic Zone,Qwen-VL,Keypoint Detection Model,JSON Parser,Email Notification,Halo Visualization,Object Detection Model,Data Aggregator,Google Gemma,Background Color Visualization,Email Notification,Ellipse Visualization,Twilio SMS/MMS Notification,Text Display,Polygon Visualization,Crop Visualization,Absolute Static Crop,Image Preprocessing,Template Matching,Model Monitoring Inference Aggregator,Relative Static Crop,OpenRouter,OpenAI,PLC ModbusTCP,VLM As Detector,Florence-2 Model,OpenAI,Heatmap Visualization,Motion Detection,OCR Model,Detections Filter,Perception Encoder Embedding Model,Blur Visualization,Barcode Detection,Dimension Collapse,Depth Estimation,Instance Segmentation Model,Stability AI Outpainting,Anthropic Claude,YOLO-World Model,Google Gemini,Clip Comparison,Google Gemini,PLC EthernetIP,Background Subtraction,Keypoint Visualization,Buffer,CSV Formatter,Webhook Sink,Byte Tracker,Stitch Images,Florence-2 Model,Current Time,Detections List Roll-Up,Contrast Equalization,Mask Edge Snap,OpenAI,Qwen3-VL,Moondream2,Line Counter,VLM As Detector,Google Gemini,Triangle Visualization,Slack Notification,Overlap Filter,Time in Zone,Inner Workflow,CLIP Embedding Model,First Non Empty Or Default,Detections Stabilizer,SIFT,Local File Sink,Multi-Label Classification Model,Cosine Similarity,Image Contours,Keypoint Detection Model,VLM As Classifier,Pixel Color Count,GLM-OCR,Roboflow Asset Library Attributes,Image Slicer,Polygon Zone Visualization,Google Gemma API,Time in Zone,Contrast Enhancement,Stitch OCR Detections,Line Counter Visualization,Image Threshold,Semantic Segmentation Model,Distance Measurement,Multi-Label Classification Model,Semantic Segmentation Model,Camera Calibration,QR Code Generator,Detection Offset,ByteTrack Tracker,Expression,Detection Event Log,Detections Transformation,S3 Sink,Microsoft SQL Server Sink,Mask Area Measurement,Google Vision OCR,Twilio SMS Notification,Image Blur,Detections Combine,Morphological Transformation,Property Definition,Camera Focus,Roboflow Vision Events,Size Measurement,Delta Filter,PTZ Tracking (ONVIF),Stability AI Inpainting,Classification Label Visualization,SAM2 Video Tracker,Stitch OCR Detections,Bounding Rectangle,Event Writer,Grid Visualization,Qwen3.5-VL,Mask Visualization,Dominant Color,Byte Tracker,Rate Limiter,Llama 3.2 Vision,Switch Case,Image Slicer,Velocity,Label Visualization,Identify Outliers,Reference Path Visualization,Byte Tracker,SIFT Comparison,OPC UA Writer Sink,Dot Visualization,Identify Changes,Cache Set,Path Deviation,Detections Stitch,Circle Visualization,Llama 3.2 Vision,BoT-SORT Tracker,SAM3 Video Tracker,Dynamic Crop,Camera Focus,Gaze Detection,Segment Anything 2 Model,OpenAI-Compatible LLM,MoonshotAI Kimi,Single-Label Classification Model,Overlap Analysis,Qwen3.5,QR Code Detection,CogVLM,Object Detection Model,SAM 3 Interactive,Qwen 3.6 API,Detections Consensus,Bounding Box Visualization,Multi-Label Classification Model,LMM,SAM 3,OpenAI,PLC Reader,Image Convert Grayscale,Instance Segmentation Model,Continue If,Roboflow Visual Search,EasyOCR,Roboflow Dataset Upload,SAM 3,Cache Get,Instance Segmentation Model,Detections Classes Replacement,Pixelate Visualization,Keypoint Detection Model,Instance Segmentation Model,SORT Tracker,PLC Writer,Roboflow Dataset Upload,Track Class Lock,Qwen 3.5 API,Object Detection Model,Anthropic Claude,Time in Zone,MQTT Writer,Polygon Visualization,OC-SORT Tracker,SAM 3,Model Comparison Visualization,Single-Label Classification Model,Seg Preview
Input and Output Bindings¶
The available connections depend on its binding kinds. Check what binding kinds
Inner Workflow in version v1 has.
Bindings
-
input
parameter_bindings(*): Maps child workflow input names to a selector (or literal coerced by the engine) from the parent. Required for every child input exceptWorkflowParameter/InferenceParameterentries that declare a non-nulldefault_value(those may be omitted and the child's default is used during compilation inlining)..
-
output
*(*): Equivalent of any element.
Example JSON definition of step Inner Workflow in version v1
{
"name": "<your_step_name_here>",
"type": "roboflow_core/inner_workflow@v1",
"workflow_definition": "<block_does_not_provide_example>",
"workflow_workspace_id": "<block_does_not_provide_example>",
"workflow_id": "<block_does_not_provide_example>",
"workflow_version_id": "<block_does_not_provide_example>",
"parameter_bindings": "<block_does_not_provide_example>"
}