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:
Detections Classes Replacement,Morphological Transformation,Image Preprocessing,Email Notification,VLM As Classifier,Halo Visualization,Morphological Transformation,Detections Transformation,Pixel Color Count,Object Detection Model,Time in Zone,Template Matching,Image Threshold,Text Display,BoT-SORT Tracker,Model Monitoring Inference Aggregator,Pixelate Visualization,Keypoint Detection Model,Time in Zone,Qwen-VL,OpenAI,CogVLM,Crop Visualization,Cosine Similarity,SAM 3,Dot Visualization,Detections Merge,Google Vision OCR,Detections List Roll-Up,PLC EthernetIP,Florence-2 Model,Dimension Collapse,Roboflow Dataset Upload,Qwen3.5-VL,Mask Edge Snap,Roboflow Vision Events,Polygon Zone Visualization,Qwen2.5-VL,Polygon Visualization,SIFT Comparison,Absolute Static Crop,S3 Sink,Twilio SMS/MMS Notification,QR Code Generator,SIFT Comparison,Contrast Enhancement,Per-Class Confidence Filter,Single-Label Classification Model,Cache Get,Stitch OCR Detections,Dynamic Zone,Detections Filter,OCR Model,Byte Tracker,Color Visualization,Roboflow Dataset Upload,Gaze Detection,Bounding Rectangle,Roboflow Custom Metadata,Environment Secrets Store,LMM For Classification,Detections Stabilizer,Line Counter Visualization,Image Blur,Stability AI Inpainting,Object Detection Model,Blur Visualization,OpenAI-Compatible LLM,Path Deviation,Current Time,SAM 3,Perspective Correction,Keypoint Visualization,Byte Tracker,Detection Offset,Anthropic Claude,MQTT Writer,MoonshotAI Kimi,Google Gemini,Identify Changes,Image Slicer,SAM 3,Depth Estimation,Detections Consensus,Detections Stitch,Ellipse Visualization,Google Gemma API,Object Detection Model,PLC ModbusTCP,Slack Notification,Overlap Analysis,Rate Limiter,Identify Outliers,Inner Workflow,Time in Zone,Image Stack,Delta Filter,Google Gemini,Cache Set,Bounding Box Visualization,Label Visualization,Keypoint Detection Model,Size Measurement,Camera Focus,Stitch OCR Detections,CSV Formatter,Keypoint Detection Model,Multi-Label Classification Model,OpenAI,SIFT,Perception Encoder Embedding Model,Anthropic Claude,Image Convert Grayscale,Roboflow Asset Library Attributes,OC-SORT Tracker,Moondream2,CLIP Embedding Model,Florence-2 Model,Seg Preview,Overlap Filter,EasyOCR,YOLO-World Model,Buffer,Segment Anything 2 Model,Multi-Label Classification Model,Twilio SMS Notification,Local File Sink,Single-Label Classification Model,Icon Visualization,Triangle Visualization,VLM As Classifier,Qwen 3.5 API,Mask Area Measurement,Path Deviation,JSON Parser,OpenRouter,Dominant Color,Instance Segmentation Model,Distance Measurement,Qwen3-VL,Instance Segmentation Model,OpenAI,Background Color Visualization,MoonshotAI Kimi,Continue If,Byte Tracker,Google Gemini,Grid Visualization,Clip Comparison,Semantic Segmentation Model,Corner Visualization,Image Slicer,Single-Label Classification Model,Reference Path Visualization,SmolVLM2,Line Counter,First Non Empty Or Default,Halo Visualization,Dynamic Crop,Webhook Sink,Instance Segmentation Model,Stability AI Outpainting,Detection Event Log,VLM As Detector,Relative Static Crop,Anthropic Claude,Expression,Clip Comparison,Multi-Label Classification Model,SORT Tracker,OpenAI,Llama 3.2 Vision,Barcode Detection,ByteTrack Tracker,Velocity,Motion Detection,Detections Combine,Camera Calibration,Model Comparison Visualization,Data Aggregator,Trace Visualization,Google Gemma,PTZ Tracking (ONVIF),Line Counter,OPC UA Writer Sink,QR Code Detection,Circle Visualization,Email Notification,LMM,Event Writer,Instance Segmentation Model,Camera Focus,Contrast Equalization,Heatmap Visualization,Background Subtraction,Image Contours,SAM2 Video Tracker,Qwen 3.6 API,GLM-OCR,Qwen3.5,VLM As Detector,Classification Label Visualization,Llama 3.2 Vision,Property Definition,Stitch Images,Mask Visualization,Microsoft SQL Server Sink,Stability AI Image Generation,Semantic Segmentation Model,Polygon Visualization - outputs:
Detections Classes Replacement,Morphological Transformation,Image Preprocessing,Email Notification,VLM As Classifier,Morphological Transformation,Halo Visualization,Detections Transformation,Pixel Color Count,Object Detection Model,BoT-SORT Tracker,Text Display,Template Matching,Time in Zone,Image Threshold,Model Monitoring Inference Aggregator,Pixelate Visualization,Keypoint Detection Model,Time in Zone,Qwen-VL,OpenAI,CogVLM,Crop Visualization,SAM 3,Cosine Similarity,Dot Visualization,Google Vision OCR,PLC EthernetIP,Detections List Roll-Up,Detections Merge,Florence-2 Model,Dimension Collapse,Roboflow Dataset Upload,Mask Edge Snap,Qwen3.5-VL,Roboflow Vision Events,Polygon Zone Visualization,Qwen2.5-VL,Polygon Visualization,SIFT Comparison,S3 Sink,Absolute Static Crop,Twilio SMS/MMS Notification,QR Code Generator,SIFT Comparison,Contrast Enhancement,Per-Class Confidence Filter,Single-Label Classification Model,Cache Get,Stitch OCR Detections,Dynamic Zone,Detections Filter,OCR Model,Byte Tracker,Color Visualization,Roboflow Dataset Upload,Gaze Detection,Roboflow Custom Metadata,Bounding Rectangle,LMM For Classification,OpenAI-Compatible LLM,Line Counter Visualization,Stability AI Inpainting,Image Blur,Object Detection Model,Blur Visualization,Detections Stabilizer,Path Deviation,Current Time,SAM 3,Perspective Correction,Keypoint Visualization,Byte Tracker,Detection Offset,Anthropic Claude,MQTT Writer,MoonshotAI Kimi,Google Gemini,Image Slicer,Identify Changes,SAM 3,Depth Estimation,Detections Consensus,Ellipse Visualization,Google Gemma API,Detections Stitch,Object Detection Model,PLC ModbusTCP,Slack Notification,Overlap Analysis,Rate Limiter,Identify Outliers,Time in Zone,Inner Workflow,Image Stack,Delta Filter,Google Gemini,Cache Set,Label Visualization,Bounding Box Visualization,Keypoint Detection Model,Stitch OCR Detections,Camera Focus,CSV Formatter,Size Measurement,Keypoint Detection Model,Multi-Label Classification Model,OpenAI,SIFT,Perception Encoder Embedding Model,Anthropic Claude,Image Convert Grayscale,OC-SORT Tracker,Roboflow Asset Library Attributes,Moondream2,CLIP Embedding Model,Florence-2 Model,Seg Preview,Overlap Filter,EasyOCR,YOLO-World Model,Multi-Label Classification Model,Segment Anything 2 Model,Twilio SMS Notification,Buffer,Local File Sink,Single-Label Classification Model,Triangle Visualization,VLM As Classifier,Qwen 3.5 API,Mask Area Measurement,Icon Visualization,Path Deviation,JSON Parser,OpenRouter,Dominant Color,Instance Segmentation Model,Distance Measurement,Qwen3-VL,Instance Segmentation Model,OpenAI,Background Color Visualization,MoonshotAI Kimi,Continue If,Byte Tracker,Google Gemini,Grid Visualization,Clip Comparison,Semantic Segmentation Model,Corner Visualization,Reference Path Visualization,Image Slicer,SmolVLM2,Single-Label Classification Model,Line Counter,Halo Visualization,First Non Empty Or Default,Webhook Sink,Dynamic Crop,Instance Segmentation Model,Stability AI Outpainting,Detection Event Log,VLM As Detector,Relative Static Crop,Anthropic Claude,SORT Tracker,Expression,Clip Comparison,Multi-Label Classification Model,OpenAI,Llama 3.2 Vision,Barcode Detection,ByteTrack Tracker,Velocity,Motion Detection,Detections Combine,Camera Calibration,PTZ Tracking (ONVIF),Trace Visualization,Model Comparison Visualization,Data Aggregator,Google Gemma,OPC UA Writer Sink,Line Counter,QR Code Detection,Circle Visualization,Email Notification,LMM,Event Writer,Instance Segmentation Model,Heatmap Visualization,Background Subtraction,Contrast Equalization,GLM-OCR,Qwen 3.6 API,Image Contours,SAM2 Video Tracker,Camera Focus,Qwen3.5,VLM As Detector,Classification Label Visualization,Llama 3.2 Vision,Property Definition,Stitch Images,Mask Visualization,Microsoft SQL Server Sink,Stability AI Image Generation,Semantic Segmentation Model,Polygon Visualization
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>"
}