creating-api-gateway-stage

Automate API Gateway stage creation with CloudWatch logging, X-Ray tracing, and IAM security.

2.3k|234|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/aws/agent-toolkit-for-aws --skill creating-api-gateway-stage-aws
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: creating-api-gateway-stage
Source: https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/serverless-skills/creating-api-gateway-stage
Command: npx skills add https://github.com/aws/agent-toolkit-for-aws --skill creating-api-gateway-stage-aws

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Automates end-to-end creation and configuration of an API Gateway stage, ensuring consistent logging, tracing, security, and throttling across environments.

Core Features & Use Cases

  • CloudWatch logging: enabled for the stage and methods to capture requests and errors.
  • X-Ray tracing: distributed tracing for end-to-end latency diagnostics.
  • WAF integration: optional protection against common web exploits.
  • Environment-aware configuration: use stage variables and deployment workflows for dev, test, and prod.
  • Throttling and caching controls: protect backends and optimize performance.
  • IAM-based access: secure management of permissions and roles for the stage.

Quick Start

Create a fully configured API Gateway stage with logging, tracing, throttling, WAF integration, and IAM roles following AWS best practices.

Frequently Asked Questions about creating-api-gateway-stage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure an API Gateway stage with CloudWatch logging and X-Ray tracing?

Configuring an API Gateway stage automates CloudWatch logging and X-Ray tracing to capture requests and diagnose end-to-end latency. It applies per-method settings to ensure consistent observability across dev, test, and prod environments.

What is the best way to apply throttling and WAF integration to a REST API stage?

Applying throttling and WAF integration involves automating stage creation to protect backends and mitigate web exploits. This configures rate limits and optional WAF rules while maintaining environment-aware stage variables.

Does API Gateway stage setup require specific IAM roles for access logging?

API Gateway stage setup requires specific IAM roles for access logging. The configuration process handles IAM role creation and permission management to securely allow API Gateway to write logs and metrics to CloudWatch.

Can I use stage variables to manage different configurations across dev, test, and prod environments?

You can use stage variables to manage configurations across dev, test, and prod environments. The stage setup supports environment-aware deployment workflows by assigning unique variables and per-method settings to each stage.

Why is my API Gateway stage not logging requests to CloudWatch even after deployment?

If an API Gateway stage is not logging requests to CloudWatch, it often indicates missing IAM roles or unconfigured method-level settings. Proper setup requires creating CloudWatch log groups, defining retention policies, and verifying IAM permissions.