Amazon API Gateway

Amazon API Gateway is a fully managed service that makes it easy to create, publish, maintain, monitor, and secure APIs at any scale. It acts as the front door for applications to access backend services, supporting REST APIs, HTTP APIs, and WebSocket APIs with built-in traffic management, authorization, monitoring, and API version management. API Gateway integrates natively with AWS Lambda, CloudWatch, CloudFront, IAM, and Cognito, and (as of December 2025) can expose REST APIs as MCP-compatible tools for Amazon Bedrock AgentCore Gateway for agent-driven API consumption.

4 APIs 19 Features

API GatewayCloudRESTHTTPWebSocketServerlessMCPAgentCoreDeveloper Portal

APIs

Amazon API Gateway V1 (REST)

The API Gateway V1 control plane API is used to create, deploy, and manage REST APIs in Amazon API Gateway. It exposes resources for RestApis, Resources, Methods, Stages, Deploy...

Amazon API Gateway V2 (HTTP and WebSocket)

The API Gateway V2 control plane API is used to create, deploy, and manage HTTP APIs and WebSocket APIs in Amazon API Gateway. It provides resources for Apis, Routes, Integratio...

Amazon API Gateway Management API

The API Gateway Management API allows backend services to send messages to connected clients of a deployed WebSocket API and to disconnect clients. Requests are made against the...

Amazon API Gateway Portals

The API Gateway Portals control plane (introduced November 19, 2025) lets you create branded developer portals that catalog REST APIs. A portal contains PortalProducts (logical ...

Collections

Amazon API Gateway Management API

POSTMAN

Amazon API Gateway V1 (REST)

POSTMAN

Amazon API Gateway V2 (HTTP and WebSocket)

POSTMAN

Amazon API Gateway Management API

OPEN

Amazon API Gateway V1 (REST)

OPEN

Amazon API Gateway V2 (HTTP and WebSocket)

OPEN

Arazzo Workflows

AWS API Gateway Add a Method and Redeploy

Verify a REST API exists, attach a method to one of its resources, and publish a fresh deployment.

ARAZZO

AWS API Gateway Audit an HTTP API Surface

Confirm an HTTP API and enumerate its routes, integrations, and stages in a single read-only pass.

ARAZZO

AWS API Gateway Build an HTTP API

Create an HTTP API, attach a backend integration, wire a route to it, and publish a stage.

ARAZZO

AWS API Gateway Build a WebSocket API

Create a WebSocket API, add an integration, and wire the $connect route to it.

ARAZZO

AWS API Gateway Create an API Key and Usage Plan

Create an API key, create a throttled and quota-limited usage plan, and confirm the plan was registered.

ARAZZO

AWS API Gateway Decommission an HTTP API

Confirm an HTTP API, check for published stages, and delete the API when it is safe to remove.

ARAZZO

AWS API Gateway Deploy an HTTP API to a New Stage

Confirm an HTTP API, create a deployment, and publish it to a new stage bound to that deployment.

ARAZZO

AWS API Gateway Inspect a REST API Method

Confirm a REST API, list its resources, and read the method configuration for a chosen resource and verb.

ARAZZO

AWS API Gateway Provision a Metered REST API

Create a REST API with a key-protected method and branch into usage-plan setup when an API key is required.

ARAZZO

AWS API Gateway Provision and Deploy a REST API

Create a REST API, configure a method on its root resource, deploy it, and confirm the stage.

ARAZZO

AWS API Gateway Redeploy a REST API Stage

Confirm a REST API, review its existing deployments, and publish a fresh deployment to a stage.

ARAZZO

AWS API Gateway Secure an HTTP API with an Authorizer

Create an HTTP API, attach an authorizer, and add a route that uses it.

ARAZZO

GraphQL

Amazon API Gateway GraphQL API

GRAPHQL

Pricing Plans

Aws Api Gateway Plans Pricing

6 plans

PLANS

Rate Limits

Aws Api Gateway Rate Limits

12 limits

RATE LIMITS

FinOps

Aws Api Gateway Finops

FINOPS

Features

REST API Management

Create, deploy, and manage REST APIs with full lifecycle control including stages, deployments, and versioning.

HTTP API Support

Build lightweight HTTP APIs optimized for serverless workloads at up to 71% lower cost than REST APIs.

WebSocket APIs

Enable real-time bidirectional communication for chat platforms, streaming dashboards, and live applications.

Traffic Management

Handle hundreds of thousands of concurrent API calls with built-in throttling and request validation.

Authorization and Security

Supports IAM policies, Lambda authorizers, Amazon Cognito user pools, and OAuth2/OIDC for API access control.

Monitoring and Logging

Integration with CloudWatch metrics, access logging, and CloudTrail for full API observability.

Custom Domain Names

Map APIs to branded custom domains with TLS certificates managed through AWS Certificate Manager.

Canary Releases

Safely roll out API changes using canary deployment stages with configurable traffic splitting.

AWS WAF Integration

Protect APIs against common web exploits and DDoS attacks using AWS Web Application Firewall.

SDK Generation

Automatically generate client SDKs for deployed APIs in multiple programming languages.

API Caching

Reduce backend load and improve response times with configurable response caching at the stage level.

CloudFront Edge Distribution

Leverage Amazon CloudFront edge locations for global low-latency API distribution.

Bedrock AgentCore Gateway MCP Target

Expose REST API stages as Model Context Protocol (MCP) tools for AI agents via Bedrock AgentCore Gateway. AgentCore translates incoming MCP requests into HTTP requests, supports tools/list and tools/call methods, and accepts API_KEY, NO_AUTH, or GATEWAY_IAM_ROLE outbound auth. Launched December 2, 2025.

Developer Portals

Native API Gateway Portals (launched November 19, 2025) let you publish PortalProducts containing REST APIs and per-endpoint documentation. Portals can be shared across AWS accounts and access-controlled via Cognito user pools.

REST API Response Streaming

REST APIs can progressively stream response payloads to clients as they become available (launched November 19, 2025), enabling long-running and incremental response patterns.

Private Integration with Application Load Balancer

REST APIs support private integrations with Application Load Balancers (launched November 21, 2025), expanding private integration options beyond NLB and AWS Cloud Map.

SIGv4a Authentication for REST APIs

REST APIs now support AWS Signature Version 4a (launched August 19, 2025), enabling multi-Region signing for cross-Region API invocations.

Enhanced TLS Security Policies

Configurable TLS security policies for REST APIs and custom domain names (launched November 19, 2025) allow tighter control over accepted protocols and ciphers.

Dual-Stack IPv4/IPv6 Endpoints

REST, HTTP, and WebSocket APIs and custom domain names support dual-stack endpoints (launched March 28, 2025).

Use Cases

Serverless API Backend

Build fully serverless APIs with API Gateway as the front door and AWS Lambda as the backend compute layer.

Microservices Gateway

Consolidate access to multiple microservices behind a single API endpoint with routing and load balancing.

Real-Time Applications

Enable chat apps, collaborative tools, and live dashboards using WebSocket APIs for persistent bidirectional connections.

Mobile and Web Application APIs

Create secure, scalable REST and HTTP APIs for mobile and web front-ends with Cognito authentication.

Legacy API Modernization

Expose existing on-premises or EC2-hosted services as modern REST APIs without rewriting backend logic.

Third-Party API Integration

Aggregate and normalize third-party APIs behind a consistent API surface with transformation and mapping.

MCP Tool Server for AI Agents

Expose REST APIs as MCP-compatible tool catalogs via Bedrock AgentCore Gateway so AI agents can list and invoke operations without bespoke client code.

Developer Portal for Partner APIs

Use native API Gateway Portals to publish partner-facing REST APIs with branded documentation, Cognito-gated access, and self-service key issuance.

Event Specifications

Amazon API Gateway WebSocket API Protocol

AsyncAPI description of the *platform protocol* exposed by Amazon API Gateway WebSocket APIs. Customer-deployed WebSocket APIs are message-routed based on a route selection expr...

ASYNCAPI

Semantic Vocabularies

Aws Api Gateway Management Connection Context

1 classes · 5 properties

JSON-LD

Aws Api Gateway Management Identity Context

1 classes · 2 properties

JSON-LD

Aws Api Gateway V1 Api Context

3 classes · 4 properties

JSON-LD

Aws Api Gateway V1 Create Context

7 classes · 10 properties

JSON-LD

Aws Api Gateway V1 Deployment Context

2 classes · 2 properties

JSON-LD

Aws Api Gateway V1 Deployments Context

1 classes · 1 properties

JSON-LD

Aws Api Gateway V1 Endpoint Context

1 classes · 1 properties

JSON-LD

Aws Api Gateway V1 Method Context

1 classes · 3 properties

JSON-LD

Aws Api Gateway V1 Put Context

1 classes · 2 properties

JSON-LD

Aws Api Gateway V1 Quota Context

1 classes · 2 properties

JSON-LD

Aws Api Gateway V1 Resource Context

1 classes · 4 properties

JSON-LD

Aws Api Gateway V1 Resources Context

1 classes · 1 properties

JSON-LD

Aws Api Gateway V1 Rest Context

5 classes · 5 properties

JSON-LD

Aws Api Gateway V1 Stage Context

2 classes · 2 properties

JSON-LD

Aws Api Gateway V1 Stages Context

1 classes · 1 properties

JSON-LD

Aws Api Gateway V1 Throttle Context

1 classes · 2 properties

JSON-LD

Aws Api Gateway V1 Usage Context

3 classes · 8 properties

JSON-LD

Aws Api Gateway V2 Api Context

1 classes · 6 properties

JSON-LD

Aws Api Gateway V2 Apis Context

1 classes · 1 properties

JSON-LD

Aws Api Gateway V2 Authorizer Context

1 classes · 4 properties

JSON-LD

Aws Api Gateway V2 Authorizers Context

1 classes · 1 properties

JSON-LD

Aws Api Gateway V2 Create Context

6 classes · 16 properties

JSON-LD

Aws Api Gateway V2 Deployment Context

1 classes · 4 properties

JSON-LD

Aws Api Gateway V2 Deployments Context

1 classes · 1 properties

JSON-LD

Aws Api Gateway V2 Integration Context

1 classes · 4 properties

JSON-LD

Aws Api Gateway V2 Integrations Context

1 classes · 1 properties

JSON-LD

Aws Api Gateway V2 Route Context

1 classes · 4 properties

JSON-LD

Aws Api Gateway V2 Routes Context

1 classes · 1 properties

JSON-LD

Aws Api Gateway V2 Stage Context

1 classes · 4 properties

JSON-LD

Aws Api Gateway V2 Stages Context

1 classes · 1 properties

JSON-LD

API Governance Rules

Amazon API Gateway API Rules

35 rules · 17 errors 17 warnings 1 info

SPECTRAL

JSON Structure

Management Connection Structure

3 properties

JSON STRUCTURE

Management Identity Structure

2 properties

JSON STRUCTURE

V1 Api Key Structure

4 properties

JSON STRUCTURE

V1 Api Keys Structure

1 properties

JSON STRUCTURE

V1 Create Api Key Request Structure

3 properties

JSON STRUCTURE

V1 Create Deployment Request Structure

2 properties

JSON STRUCTURE

V1 Create Rest Api Request Structure

4 properties

JSON STRUCTURE

V1 Create Usage Plan Request Structure

4 properties

JSON STRUCTURE

V1 Deployment Structure

3 properties

JSON STRUCTURE

V1 Deployments Structure

1 properties

JSON STRUCTURE

V1 Endpoint Configuration Structure

1 properties

JSON STRUCTURE

V1 Method Structure

3 properties

JSON STRUCTURE

V1 Put Method Request Structure

2 properties

JSON STRUCTURE

V1 Quota Settings Structure

2 properties

JSON STRUCTURE

V1 Resource Structure

4 properties

JSON STRUCTURE

V1 Resources Structure

1 properties

JSON STRUCTURE

V1 Rest Api Structure

6 properties

JSON STRUCTURE

V1 Rest Apis Structure

1 properties

JSON STRUCTURE

V1 Stage Structure

3 properties

JSON STRUCTURE

V1 Stages Structure

1 properties

JSON STRUCTURE

V1 Throttle Settings Structure

2 properties

JSON STRUCTURE

V1 Usage Plan Structure

4 properties

JSON STRUCTURE

V1 Usage Plans Structure

1 properties

JSON STRUCTURE

V2 Api Structure

6 properties

JSON STRUCTURE

V2 Apis Structure

1 properties

JSON STRUCTURE

V2 Authorizer Structure

4 properties

JSON STRUCTURE

V2 Authorizers Structure

1 properties

JSON STRUCTURE

V2 Create Api Request Structure

5 properties

JSON STRUCTURE

V2 Create Authorizer Request Structure

4 properties

JSON STRUCTURE

V2 Create Deployment Request Structure

2 properties

JSON STRUCTURE

V2 Create Integration Request Structure

3 properties

JSON STRUCTURE

V2 Create Route Request Structure

3 properties

JSON STRUCTURE

V2 Create Stage Request Structure

3 properties

JSON STRUCTURE

V2 Deployment Structure

4 properties

JSON STRUCTURE

V2 Deployments Structure

1 properties

JSON STRUCTURE

V2 Integration Structure

4 properties

JSON STRUCTURE

V2 Integrations Structure

1 properties

JSON STRUCTURE

V2 Route Structure

4 properties

JSON STRUCTURE

V2 Routes Structure

1 properties

JSON STRUCTURE

V2 Stage Structure

4 properties

JSON STRUCTURE

V2 Stages Structure

1 properties

JSON STRUCTURE

Example Payloads

Management Connection Example

3 fields

EXAMPLE

Management Identity Example

2 fields

EXAMPLE

V1 Api Key Example

4 fields

EXAMPLE

V1 Api Keys Example

1 fields

EXAMPLE

V1 Create Api Key Request Example

3 fields

EXAMPLE

V1 Create Deployment Request Example

2 fields

EXAMPLE

V1 Create Rest Api Request Example

4 fields

EXAMPLE

V1 Create Usage Plan Request Example

4 fields

EXAMPLE

V1 Deployment Example

3 fields

EXAMPLE

V1 Deployments Example

1 fields

EXAMPLE

V1 Endpoint Configuration Example

1 fields

EXAMPLE

V1 Method Example

3 fields

EXAMPLE

V1 Put Method Request Example

2 fields

EXAMPLE

V1 Quota Settings Example

2 fields

EXAMPLE

V1 Resource Example

4 fields

EXAMPLE

V1 Resources Example

1 fields

EXAMPLE

V1 Rest Api Example

6 fields

EXAMPLE

V1 Rest Apis Example

1 fields

EXAMPLE

V1 Stage Example

3 fields

EXAMPLE

V1 Stages Example

1 fields

EXAMPLE

V1 Throttle Settings Example

2 fields

EXAMPLE

V1 Usage Plan Example

4 fields

EXAMPLE

V1 Usage Plans Example

1 fields

EXAMPLE

V2 Api Example

6 fields

EXAMPLE

V2 Apis Example

1 fields

EXAMPLE

V2 Authorizer Example

4 fields

EXAMPLE

V2 Authorizers Example

1 fields

EXAMPLE

V2 Create Api Request Example

5 fields

EXAMPLE

V2 Create Authorizer Request Example

4 fields

EXAMPLE

V2 Create Deployment Request Example

2 fields

EXAMPLE

V2 Create Integration Request Example

3 fields

EXAMPLE

V2 Create Route Request Example

3 fields

EXAMPLE

V2 Create Stage Request Example

3 fields

EXAMPLE

V2 Deployment Example

4 fields

EXAMPLE

V2 Deployments Example

1 fields

EXAMPLE

V2 Integration Example

4 fields

EXAMPLE

V2 Integrations Example

1 fields

EXAMPLE

V2 Route Example

4 fields

EXAMPLE

V2 Routes Example

1 fields

EXAMPLE

V2 Stage Example

4 fields

EXAMPLE

V2 Stages Example

1 fields

EXAMPLE

Resources

GitHubOrganization

GitHubOrganization

👥

AWS Samples (121+ API Gateway sample repos)

RateLimitsArtifact

Sources

opencollection: 1.0.0
info:
  name: Amazon API Gateway V2 (HTTP and WebSocket)
  version: '2018-11-29'
request:
  auth:
    type: apikey
    key: Authorization
    value: '{{Authorization}}'
    placement: header
items:
- info:
    name: Default
    type: folder
  items:
  - info:
      name: Amazon API Gateway List APIs
      type: http
    http:
      method: GET
      url: https://apigateway.{region}.amazonaws.com/v2/apis
    docs: Gets a collection of HTTP and WebSocket APIs.
  - info:
      name: Amazon API Gateway Create an API
      type: http
    http:
      method: POST
      url: https://apigateway.{region}.amazonaws.com/v2/apis
      body:
        type: json
        data: '{}'
    docs: Creates an HTTP or WebSocket API.
  - info:
      name: Amazon API Gateway Get an API
      type: http
    http:
      method: GET
      url: https://apigateway.{region}.amazonaws.com/v2/apis/:api_id
      params:
      - name: api_id
        value: ''
        type: path
        description: API identifier.
    docs: Retrieves a single HTTP or WebSocket API.
  - info:
      name: Amazon API Gateway Delete an API
      type: http
    http:
      method: DELETE
      url: https://apigateway.{region}.amazonaws.com/v2/apis/:api_id
      params:
      - name: api_id
        value: ''
        type: path
        description: API identifier.
    docs: Deletes the specified API.
- info:
    name: Routes
    type: folder
  items:
  - info:
      name: Amazon API Gateway List Routes
      type: http
    http:
      method: GET
      url: https://apigateway.{region}.amazonaws.com/v2/apis/:api_id/routes
      params:
      - name: api_id
        value: ''
        type: path
        description: API identifier.
    docs: Gets a collection of routes for an API.
  - info:
      name: Amazon API Gateway Create a Route
      type: http
    http:
      method: POST
      url: https://apigateway.{region}.amazonaws.com/v2/apis/:api_id/routes
      params:
      - name: api_id
        value: ''
        type: path
        description: API identifier.
      body:
        type: json
        data: '{}'
    docs: Creates a route for an API.
- info:
    name: Integrations
    type: folder
  items:
  - info:
      name: Amazon API Gateway List Integrations
      type: http
    http:
      method: GET
      url: https://apigateway.{region}.amazonaws.com/v2/apis/:api_id/integrations
      params:
      - name: api_id
        value: ''
        type: path
        description: API identifier.
    docs: Gets a collection of integrations for an API.
  - info:
      name: Amazon API Gateway Create an Integration
      type: http
    http:
      method: POST
      url: https://apigateway.{region}.amazonaws.com/v2/apis/:api_id/integrations
      params:
      - name: api_id
        value: ''
        type: path
        description: API identifier.
      body:
        type: json
        data: '{}'
    docs: Creates an integration for an API.
- info:
    name: Stages
    type: folder
  items:
  - info:
      name: Amazon API Gateway List Stages
      type: http
    http:
      method: GET
      url: https://apigateway.{region}.amazonaws.com/v2/apis/:api_id/stages
      params:
      - name: api_id
        value: ''
        type: path
        description: API identifier.
    docs: Gets a collection of stages for an API.
  - info:
      name: Amazon API Gateway Create a Stage
      type: http
    http:
      method: POST
      url: https://apigateway.{region}.amazonaws.com/v2/apis/:api_id/stages
      params:
      - name: api_id
        value: ''
        type: path
        description: API identifier.
      body:
        type: json
        data: '{}'
    docs: Creates a deployment stage for an API.
- info:
    name: Deployments
    type: folder
  items:
  - info:
      name: Amazon API Gateway List Deployments
      type: http
    http:
      method: GET
      url: https://apigateway.{region}.amazonaws.com/v2/apis/:api_id/deployments
      params:
      - name: api_id
        value: ''
        type: path
        description: API identifier.
    docs: Gets a collection of deployments for an API.
  - info:
      name: Amazon API Gateway Create a Deployment
      type: http
    http:
      method: POST
      url: https://apigateway.{region}.amazonaws.com/v2/apis/:api_id/deployments
      params:
      - name: api_id
        value: ''
        type: path
        description: API identifier.
      body:
        type: json
        data: '{}'
    docs: Creates a deployment for an API.
- info:
    name: Authorizers
    type: folder
  items:
  - info:
      name: Amazon API Gateway List Authorizers
      type: http
    http:
      method: GET
      url: https://apigateway.{region}.amazonaws.com/v2/apis/:api_id/authorizers
      params:
      - name: api_id
        value: ''
        type: path
        description: API identifier.
    docs: Gets a collection of authorizers for an API.
  - info:
      name: Amazon API Gateway Create an Authorizer
      type: http
    http:
      method: POST
      url: https://apigateway.{region}.amazonaws.com/v2/apis/:api_id/authorizers
      params:
      - name: api_id
        value: ''
        type: path
        description: API identifier.
      body:
        type: json
        data: '{}'
    docs: Creates an authorizer for an API.
bundled: true