v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1426173136.4 KB

Used by activity workers and task states using the <a href="https://docs.aws.amazon.com/step-functions/latest/dg/connect-to-resource.html#connect-wait-token">callback</a> pattern to report that the task identified by the <code>taskToken</code> failed.

post/#X-Amz-Target=AWSStepFunctions.SendTaskFailure

Headers

X-Amz-Target'AWSStepFunctions.SendTaskFailure' required

Request body

taskTokenstring required

The token that represents this task. Task tokens are generated by Step Functions when tasks are assigned to a worker, or in the <a href="https://docs.aws.amazon.com/step-functions/latest/dg/input-output-contextobject.html">context object</a> when a workflow enters a task state. See <a>GetActivityTaskOutput$taskToken</a>.

errorstring password

The error code of the failure.

causestring password

A more detailed explanation of the cause of the failure.

Response

Success

SendTaskFailureOutput required