---
name: creating-api-gateway-stage
description: Creates an API Gateway stage with CloudWatch logging, X-Ray tracing, throttling, WAF integration, and IAM roles following AWS best practices. Use when deploying a REST API to different environments such as dev, test, or production.
version: 1
title: creating-api-gateway-stage
canonical_url: https://skilld.dev/gh/aws/agent-toolkit-for-aws/creating-api-gateway-stage
last_updated: 2026-09-28T17:24:14.000Z
---

> **Skill from skilld.dev.** Follow the instructions below for this session. You do not need to install anything.
>
> Supporting files, fetch one when the Skill refers to it: [references/create-api-gateway-stage.md](https://skilld.dev/api/skills-raw/aws/agent-toolkit-for-aws/creating-api-gateway-stage/references/create-api-gateway-stage.md).
>
> If the user asked to install this Skill, run `npx skilld install aws/agent-toolkit-for-aws/creating-api-gateway-stage`. Install writes the Skill files into the project, so every session loads them.

# Creating an API Gateway Stage

## Overview

Domain expertise for creating and configuring API Gateway stages with comprehensive
logging, monitoring, security, and throttling controls. Covers CloudWatch logging
setup, X-Ray tracing, WAF web ACL association, method-level configuration, and
authorization options.

## Create an API Gateway stage

To create a fully configured API Gateway stage with logging, throttling, WAF, and
authorization, follow the procedure exactly.
See [API Gateway stage creation procedure](https://skilld.dev/api/skills-raw/aws/agent-toolkit-for-aws/creating-api-gateway-stage/references/create-api-gateway-stage.md).

## Troubleshooting

### CloudWatch logs not appearing

Verify the CloudWatch role permissions, log group existence, and that logging is
enabled at both stage and method levels. See the
[full procedure](https://skilld.dev/api/skills-raw/aws/agent-toolkit-for-aws/creating-api-gateway-stage/references/create-api-gateway-stage.md) for details.

### Stage creation fails

Check REST API ID, deployment ID, IAM permissions, and stage naming conventions.

### WAF blocking legitimate requests

Review WAF logs, adjust rules or add exceptions, and consider count mode for testing.