Skip to content

Start Workflow

"type" : "START_WORKFLOW"

The Start Workflow task (START_WORKFLOW) starts another workflow from the current workflow. Unlike the Sub Workflow task, the workflow triggered by the Start Workflow task will execute asynchronously. That means the current workflow proceeds to its next task without waiting for the started workflow to complete.

A Start Workflow task is marked as COMPLETED when the requested workflow enters the RUNNING state, regardless of its final state.

Task parameters

Use these parameters inside inputParameters in the Start Workflow task configuration.

Parameter Type Description Required / Optional
inputParameters.startWorkflow Map[String, Any] A map that includes the requested workflow’s configuration, such as the name and version. Refer to Start Workflow Request for what to include in this parameter. Required.

Task configuration

Here is the task configuration for a Start Workflow task.​

{
  "name": "start_workflow",
  "taskReferenceName": "start_workflow_ref",
  "inputParameters": {
    "startWorkflow": {
      "name": "someName",
      "input": {
        "someParameter": "someValue",
        "anotherParameter": "anotherValue"
      },
      "version": 1,
      "correlationId": ""
    }
  },
  "type": "START_WORKFLOW"
}

Output

The Start Workflow task will return the following parameters.

Name Type Description
workflowId String The workflow execution ID of the started workflow.

Limitations

Because the Start Workflow task will neither wait for the completion of the started workflow nor pass back its output, it is not possible to access the output of the started workflow from the current workflow. If required, you can use the Sub Workflow task instead.