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