AutoGineer
Generated banner for Creating API Gateway Stage
Generated logo for Creating API Gateway Stage

Creating API Gateway Stage

AWSOfficialPublished by AWS

  • Skill
  • Workflow
  • Cloud and DevOps
  • Apache-2.0
  • No issues found
Download ZIP

From the author

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.
— the description by AWS

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

This skill provides a structured procedure for creating and configuring API Gateway stages. It automates the setup of essential infrastructure components including CloudWatch logging, X-Ray tracing, WAF integration, and necessary IAM roles. The workflow ensures that API stages are initialized with consistent settings for logging levels, metrics, and throttling limits, following standard AWS configuration patterns.

What it does

  • Validates the existence of REST API and deployment resources
  • Configures CloudWatch logging roles and permissions for API Gateway
  • Enables detailed CloudWatch metrics and execution logging
  • Integrates WAF web ACLs for enhanced security
  • Sets up throttling rate and burst limits for API stages
  • Configures X-Ray tracing for request monitoring

When to use it

  • When deploying a new REST API stage to environments like dev, test, or prod
  • When standardizing logging and monitoring configurations across API stages
  • When implementing security controls like WAF and throttling for API endpoints
  • When setting up the required IAM infrastructure for API Gateway logging

Advantages

  • Ensures consistent configuration of logging and security across environments
  • Automates the creation and attachment of required IAM roles
  • Provides built-in validation for API Gateway resources before deployment
  • Simplifies the setup of complex monitoring and tracing features

Usage examples

“Create a new dev stage for my API with ID abc123xyz and deployment ID dep987.”
The agent initiates the workflow to validate the API and deployment, checks for existing IAM roles, and creates the dev stage with default logging and security settings.
“Set up a production stage for API xyz789 with custom throttling limits.”
The agent executes the deployment procedure, applying the specified rate and burst limits while ensuring WAF and CloudWatch logging are correctly configured.

Install

  1. Download the skill as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/aws/creating-api-gateway-stage/download

  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip creating-api-gateway-stage.zip -d .agents/skills

Documentation by AWS

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.

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 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.

Files

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Published by
AWS
Publisher
AWS (Official)
Source
aws/agent-toolkit-for-aws · skills/specialized-skills/serverless-skills/creating-api-gateway-stage · commit 0a218f8
Licence
Apache License 2.0 (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • NOTICE (added by AutoGineer from NOTICE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by AWS.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download creating-api-gateway-stage.zip