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

# aws-cdk.aws-apigateway — The CDK Construct Library for AWS::ApiGateway

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

## 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 above — 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

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

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

## Tags

api gateway cdk construct, rest api infrastructure as code, lambda api gateway integration, aws cdk api deployment, serverless api definition, step functions api gateway, api gateway authorizers cdk, aws-cdk, infrastructure-as-code, end-of-life

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