aws-cdk.aws-apigateway

What it is and what it does

This package is the AWS CDK v1 construct library for Amazon API Gateway, a managed service for publishing and securing APIs at scale. It provides high-level Python classes to define REST APIs as infrastructure code, with built-in support for common backend integrations (Lambda functions, Step Functions state machines), authorization patterns (IAM, Lambda-based, Cognito), and operational features like access logging, CORS, and custom domains.

The library abstracts CloudFormation resource creation, allowing developers to define API hierarchies (resources and methods) programmatically and deploy them alongside other AWS infrastructure. However, the package reached end-of-support on 2023-06-01; AWS recommends migrating to AWS CDK v2 for continued updates and support.

Use it for:

• Define a REST API backed by Lambda functions using LambdaRestApi construct for serverless application endpoints.
• Build synchronous Step Functions workflows exposed as HTTP APIs using StepFunctionsRestApi for orchestrated backend logic.
• Configure API authorization with Cognito User Pools, IAM roles, or custom Lambda authorizers for access control.
• Set up custom domain names, SSL certificates, and access logging for production API deployments.
• Break large APIs across multiple CloudFormation stacks to work around resource limits while maintaining a unified API structure.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides AWS CDK constructs for defining and deploying Amazon API Gateway REST APIs, including Lambda and Step Functions integrations, authorizers, and deployment configuration.

No—this is AWS CDK v1, which reached end-of-support on 2023-06-01. While the package itself has low install friction and no known vulnerabilities, AWS explicitly recommends migration to AWS CDK v2. Install only if you are maintaining an existing v1 codebase; for new projects, use aws-cdk.aws-apigateway v2 instead.

Install

aws-cdk-aws-apigateway on PyPI

pip install aws-cdk-aws-apigateway

uv add aws-cdk-aws-apigateway

poetry add aws-cdk-aws-apigateway

Installing aws-cdk.aws-apigateway

Before you install

Low install friction with a wheel distribution. Package is actively maintained in the repository (last commit 2026-08-14), though it is classified as Development Status :: 7 - Inactive and reached end-of-support on 2023-06-01; users should migrate to AWS CDK v2.

License in practice

Licensed under Apache-2.0 (permissive), allowing commercial use, modification, and distribution with minimal restrictions.

Quickstart

from aws_cdk import aws_apigateway as apigateway
from aws_cdk import aws_lambda as lambda_

api = apigateway.RestApi(self, "books-api")
books = api.root.add_resource("books")
books.add_method("GET")

# Or with Lambda backend:
backend = lambda_.Function(...)
apigateway.LambdaRestApi(self, "myapi", handler=backend)

Requires AWS CDK v1 environment; package is end-of-support as of 2023-06-01 and migration to AWS CDK v2 is recommended.

Verify before relying

• Whether existing v1 deployments remain functional despite end-of-support status and what breaking changes may occur in AWS infrastructure.
• Performance characteristics and limits when handling high-volume API traffic through the constructs provided.

Package facts

Evidence: aws_cdk.aws_apigateway-1.204.0-py3-none-any.whl

Tags

More Build Tools packages