# StartChildWorkflowExecutionFailedEventAttributes
<a name="API_StartChildWorkflowExecutionFailedEventAttributes"></a>

Provides the details of the `StartChildWorkflowExecutionFailed` event.

## Contents
<a name="API_StartChildWorkflowExecutionFailedEventAttributes_Contents"></a>

 ** cause **   <a name="SWF-Type-StartChildWorkflowExecutionFailedEventAttributes-cause"></a>
The cause of the failure. This information is generated by the system and can be useful for diagnostic purposes.  
When `cause` is set to `OPERATION_NOT_PERMITTED`, the decision fails because it lacks sufficient permissions. For details and example IAM policies, see [ Using IAM to Manage Access to Amazon SWF Workflows](https://docs.aws.amazon.com/amazonswf/latest/developerguide/swf-dev-iam.html) in the *Amazon SWF Developer Guide*.
Type: String  
Valid Values: `WORKFLOW_TYPE_DOES_NOT_EXIST | WORKFLOW_TYPE_DEPRECATED | OPEN_CHILDREN_LIMIT_EXCEEDED | OPEN_WORKFLOWS_LIMIT_EXCEEDED | CHILD_CREATION_RATE_EXCEEDED | WORKFLOW_ALREADY_RUNNING | DEFAULT_EXECUTION_START_TO_CLOSE_TIMEOUT_UNDEFINED | DEFAULT_TASK_LIST_UNDEFINED | DEFAULT_TASK_START_TO_CLOSE_TIMEOUT_UNDEFINED | DEFAULT_CHILD_POLICY_UNDEFINED | OPERATION_NOT_PERMITTED`   
Required: Yes

 ** decisionTaskCompletedEventId **   <a name="SWF-Type-StartChildWorkflowExecutionFailedEventAttributes-decisionTaskCompletedEventId"></a>
The ID of the `DecisionTaskCompleted` event corresponding to the decision task that resulted in the `StartChildWorkflowExecution` [Decision](API_Decision.md) to request this child workflow execution. This information can be useful for diagnosing problems by tracing back the chain of events.  
Type: Long  
Required: Yes

 ** initiatedEventId **   <a name="SWF-Type-StartChildWorkflowExecutionFailedEventAttributes-initiatedEventId"></a>
When the `cause` is `WORKFLOW_ALREADY_RUNNING`, `initiatedEventId` is the ID of the `StartChildWorkflowExecutionInitiated` event that corresponds to the `StartChildWorkflowExecution` [Decision](API_Decision.md) to start the workflow execution. You can use this information to diagnose problems by tracing back the chain of events leading up to this event.  
When the `cause` isn't `WORKFLOW_ALREADY_RUNNING`, `initiatedEventId` is set to `0` because the `StartChildWorkflowExecutionInitiated` event doesn't exist.  
Type: Long  
Required: Yes

 ** workflowId **   <a name="SWF-Type-StartChildWorkflowExecutionFailedEventAttributes-workflowId"></a>
The `workflowId` of the child workflow execution.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Required: Yes

 ** workflowType **   <a name="SWF-Type-StartChildWorkflowExecutionFailedEventAttributes-workflowType"></a>
The workflow type provided in the `StartChildWorkflowExecution` [Decision](API_Decision.md) that failed.  
Type: [WorkflowType](API_WorkflowType.md) object  
Required: Yes

 ** control **   <a name="SWF-Type-StartChildWorkflowExecutionFailedEventAttributes-control"></a>
The data attached to the event that the decider can use in subsequent workflow tasks. This data isn't sent to the child workflow execution.  
Type: String  
Length Constraints: Maximum length of 32768.  
Required: No

## See Also
<a name="API_StartChildWorkflowExecutionFailedEventAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/swf-2012-01-25/StartChildWorkflowExecutionFailedEventAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/swf-2012-01-25/StartChildWorkflowExecutionFailedEventAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/swf-2012-01-25/StartChildWorkflowExecutionFailedEventAttributes)