Actions8
Overview
This node integrates with AWS Step Functions, specifically enabling interaction with task tokens that represent asynchronous tasks within a state machine workflow. The "Send Task Success" operation allows the user to report back to AWS Step Functions that a particular task has completed successfully by providing the associated task token and the output of the task.
Common scenarios for this node include:
- Workers or external systems that perform tasks asynchronously and need to notify AWS Step Functions upon successful completion.
- Custom workflows where tasks are delegated outside of AWS Step Functions but require signaling success back to the state machine.
- Use cases where the output of a task needs to be passed back to the state machine to continue execution.
Example: A Lambda function or an external service processes a job and then uses this node to send the success signal along with the result data back to the Step Functions workflow using the provided task token.
Properties
| Name | Meaning |
|---|---|
| Task Token | The token representing the specific task assigned by AWS Step Functions. It is required to identify which task is being reported as successful. |
| Output | The JSON-formatted output of the task. This data will be sent back to AWS Step Functions as the result of the task. Length limits apply (UTF-8). |
Output
The node outputs a JSON object reflecting the response from the AWS Step Functions API after sending the task success signal. Typically, this response is empty or contains metadata confirming the success of the operation.
No binary data is produced by this operation.
Dependencies
- Requires valid AWS credentials with permissions to interact with AWS Step Functions.
- The node uses the AWS SDK internally to communicate with the Step Functions service.
- Proper configuration of AWS access key, secret key, and region is necessary in n8n credentials.
Troubleshooting
- Invalid or expired task token: If the task token is incorrect or expired, AWS will reject the request. Ensure the token is obtained freshly from the Step Functions context.
- Output size too large: The output JSON must respect AWS Step Functions payload size limits (expressed in bytes UTF-8 encoded). Large outputs may cause errors.
- Permission errors: Make sure the AWS credentials used have the necessary IAM permissions to call
SendTaskSuccess. - Network or connectivity issues: Failures in reaching AWS endpoints can cause errors; verify network access and AWS service availability.
- Error handling: If the node is set to continue on failure, it will append error details to the output; otherwise, it throws an error stopping execution.