---
id: aws-cdk-aws-stepfunctions
version: "1.204.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aws-cdk.aws-stepfunctions — The CDK Construct Library for AWS::StepFunctions

License: permissive · Maintenance: active · Downloads: 141.7K/mo

## What it is and what it does

This package provides Python classes and constructs for building AWS Step Functions state machines within the AWS CDK v1 framework. It models the Amazon States Language, allowing you to define workflows programmatically by chaining states such as Task, Pass, Wait, Choice, Parallel, Succeed, Fail, and Map. State data flows through the workflow as JSON, transformed by each state, and you can use the JsonPath class to reference and manipulate that data at each step.

The package depends on core CDK modules (aws-cloudwatch, aws-events, aws-iam, aws-logs, aws-s3, aws-cdk.core) and constructs, and is typically used alongside aws-cdk.aws-stepfunctions-tasks to invoke other AWS services. However, AWS CDK v1 reached end-of-support on 2023-06-01 and is no longer maintained; the AWS team recommends migrating to AWS CDK v2 for ongoing support and updates.

Use it for:

- Define serverless workflows that orchestrate Lambda functions, wait states, and conditional branching without writing raw JSON state machine definitions.
- Build job-polling patterns where a workflow submits a job, waits for status updates, and handles success or failure outcomes.
- Create multi-step data processing pipelines that integrate with AWS services like S3, CloudWatch, and IAM through CDK constructs.
- Prototype and test state machine logic in Python before deploying to AWS Step Functions.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Python constructs for defining AWS Step Functions state machines using AWS CDK v1, enabling serverless workflow orchestration through code.

No. This package is end-of-support as of 2023-06-01 and receives no further updates. AWS CDK v1 users should migrate to AWS CDK v2 to maintain security, compatibility, and access to new features. Installing this package locks you into an unsupported version with no path forward for bug fixes or enhancements.

## Install

pip install aws-cdk-aws-stepfunctions
uv add aws-cdk-aws-stepfunctions
poetry add aws-cdk-aws-stepfunctions

## Installing aws-cdk.aws-stepfunctions

Before you install: Low install friction with pure Python wheel distribution. However, this is AWS CDK v1, which reached end-of-support on 2023-06-01 and is no longer being updated—users should migrate to AWS CDK v2.

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial and private use with minimal restrictions.

Quickstart:

import aws_cdk.aws_stepfunctions as sfn
from aws_cdk import Duration

start_state = sfn.Pass(self, "StartState")
sfn.StateMachine(self, "StateMachine",
    definition=start_state,
    timeout=Duration.minutes(5)
)

Requires AWS CDK v1 environment; v1 is end-of-support as of 2023-06-01 and no longer receives updates.

Verify before relying:

- Whether migration tooling from v1 to v2 is available and how complex the transition typically is
- Current community support status and availability of v1-specific documentation or forums

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 141.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

aws step functions cdk, serverless workflow orchestration, state machine definition python, aws cdk construct library, workflow automation aws, end-of-life, aws-cdk-v1, deprecated

[View on SkillFed](https://skillfed.io/packages/aws-cdk-aws-stepfunctions) · [View on PyPI](https://pypi.org/project/aws-cdk-aws-stepfunctions/)