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