creating-api-gateway-stage

Create API Gateway stages with logging, tracing, throttling, and WAF.

Updated May 12, 2026
One-click install
npx skills add https://github.com/mreferre/aws-agent-toolkit-skills --skill creating-api-gateway-stage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: creating-api-gateway-stage
Source: https://github.com/mreferre/aws-agent-toolkit-skills/tree/main/.kiro/skills/creating-api-gateway-stage
Command: npx skills add https://github.com/mreferre/aws-agent-toolkit-skills --skill creating-api-gateway-stage

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

You need to deploy the same API Gateway stage across environments while ensuring consistent logging, tracing, throttling, WAF protection, and secure IAM setup without manually stitching everything together.

Core Features & Use Cases

  • CloudWatch logging and retention: Creates/uses the correct CloudWatch role and log group, then applies sensible retention so operational visibility is reliable.
  • X-Ray tracing and monitoring: Enables distributed tracing and method-level metrics for faster diagnosis and performance tuning.
  • Security hardening with throttling and WAF: Applies stage throttling and can create/associate a WAFv2 Web ACL to reduce abuse and block common threats; supports method-level authorization decisions conceptually.

Quick Start

Ask the skill to create the API Gateway stage using your REST API ID, deployment ID, and desired stage name, enabling logging, X-Ray, throttling, and WAF association as specified.

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?

To configure an API Gateway stage with CloudWatch logging and X-Ray tracing, you need to establish CloudWatch account settings, create stage log groups, enable execution and access logging, and turn on distributed tracing for faster diagnosis and performance tuning.

What is the best way to harden API Gateway deployments across multiple environments?

The best way to harden API Gateway deployments across environments is to apply consistent security and observability controls, including stage throttling, WAFv2 Web ACL association, and required IAM roles, ensuring reliable protection without manual stitching.

Can I associate a WAFv2 Web ACL with an API Gateway stage?

Yes, you can associate a WAFv2 Web ACL with an API Gateway stage. This integration reduces abuse and blocks common threats by applying stage-level security hardening alongside throttling and method-level authorization decisions.

How do I set up throttling on a REST API stage in AWS?

You set up throttling on a REST API stage by applying stage throttling configurations during the stage creation process, which helps control traffic rates and protect backend resources from being overwhelmed by excessive requests.

Do I need specific IAM roles to enable API Gateway execution logging?

Yes, you need specific IAM roles to enable API Gateway execution logging. The service requires an ARN with permissions to create log streams and put log events, ensuring the gateway can write access and execution logs to CloudWatch.

What are the limitations of relying on stage-level throttling for API security?

Stage-level throttling limits request rates but does not block malicious payloads or common web exploits; combining throttling with a WAFv2 Web ACL is necessary to achieve comprehensive threat mitigation and security hardening for your APIs.