Step Functions

Protocol: JSON 1.1 (X-Amz-Target: AmazonStatesService.*) Endpoint: POST http://localhost:4566/

Supported Actions

Action	Description
CreateStateMachine	Create a state machine (Standard or Express)
DescribeStateMachine	Get state machine definition and metadata
ListStateMachines	List all state machines
DeleteStateMachine	Delete a state machine
StartExecution	Start a new execution
DescribeExecution	Get execution status and output
ListExecutions	List executions for a state machine
StopExecution	Stop a running execution
GetExecutionHistory	Get the full event history of an execution
SendTaskSuccess	Report task success (for .waitForTaskToken tasks)
SendTaskFailure	Report task failure
SendTaskHeartbeat	Send a heartbeat for long-running tasks

Examples

export AWS_ENDPOINT=http://localhost:4566

# Create a state machine
SM_ARN=$(aws stepfunctions create-state-machine \
  --name my-workflow \
  --definition '{
    "Comment": "Simple workflow",
    "StartAt": "HelloWorld",
    "States": {
      "HelloWorld": {
        "Type": "Pass",
        "Result": {"message": "Hello, World!"},
        "End": true
      }
    }
  }' \
  --role-arn arn:aws:iam::000000000000:role/step-functions-role \
  --query stateMachineArn --output text \
  --endpoint-url $AWS_ENDPOINT)

# Start an execution
EXEC_ARN=$(aws stepfunctions start-execution \
  --state-machine-arn $SM_ARN \
  --input '{"key":"value"}' \
  --query executionArn --output text \
  --endpoint-url $AWS_ENDPOINT)

# Check status
aws stepfunctions describe-execution \
  --execution-arn $EXEC_ARN \
  --endpoint-url $AWS_ENDPOINT

# Get event history
aws stepfunctions get-execution-history \
  --execution-arn $EXEC_ARN \
  --endpoint-url $AWS_ENDPOINT