# Document history
Add an API Gateway REST API as a target for Amazon Bedrock AgentCore Gateway

API Gateway now supports adding a REST API as a target for Amazon Bedrock AgentCore Gateway. For more information, see [Add an API Gateway REST API as a target for Amazon Bedrock AgentCore Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/mcp-server.html).Private integration with Application Load Balancer

API Gateway now supports private integrations with Application Load Balancers for REST APIs. For more information, see [Private integrations for REST APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/private-integration.html).Developer portals

API Gateway now supports portals, which are a centralized location for your customers to discover and test your APIs and portal products which represent a service or functionality that you want to share. For more information, see [API Gateway portals](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-portals.html).Security policies for REST APIs and custom domain names

API Gateway now supports enhanced TLS security policies on REST APIs and custom domain names. For more information, see [Security policies for REST APIs in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-security-policies.html).Response streaming for REST APIs

API Gateway REST APIs now support progressively streaming response payloads to clients as they become available. For more information, see [Stream the integration response for your proxy integrations](https://docs.aws.amazon.com/apigateway/latest/developerguide/response-transfer-mode.html).SIGv4a for REST APIs

API Gateway now supports using Signature Version 4a for REST APIs. For more information, see [API Gateway permissions model for invoking an API](https://docs.aws.amazon.com/apigateway/latest/developerguide/permissions.html#api-gateway-control-access-iam-permissions-model-for-calling-api).Routing rules for REST APIs

API Gateway now supports routing rules for REST APIs using custom domain names. You can dynamically route incoming requests based on HTTP header values, URL base paths, or a combination of both. For more information, see [Send traffic to your APIs through your custom domain name](https://docs.aws.amazon.com/apigateway/latest/developerguide/rest-api-routing-mode.html).Added support for dual-stack (IPv4 and IPv6) endpoints

API Gateway now supports dual-stack endpoints for REST, HTTP, and WebSocket APIs, and custom domain names. For more information, see [IP address types](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-ip-address-type.html).Custom domain names for private APIs

Added support for custom domain names for private APIs. For more information, see [Custom domain names for private APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-private-custom-domains.html).Added support for TLS 1.3

API Gateway now supports TLS 1.3 on Regional REST APIs, HTTP APIs, and WebSocket APIs. For more information, see [Choosing a security policy for your custom domain in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-custom-domain-tls-version.html).REST API and WebSocket API console updates

Updated console information for REST APIs and WebSocket APIs.Documentation update

Updated conceptual information and created new tutorials for data transformations and request validation topics for API Gateway REST APIs. For more information, see [Use request validation in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-method-request-validation.html) and [Setting up data transformations for REST API](https://docs.aws.amazon.com/apigateway/latest/developerguide/rest-api-data-transformations.html).Configure DNS failover for a multi-Region API Gateway

Added support to use Amazon Route 53 health checks to control DNS failover from an API Gateway REST API in a primary AWS Region to one in a secondary Region. For more information, see [Configure custom health checks for DNS failover](https://docs.aws.amazon.com/apigateway/latest/developerguide/dns-failover.html).Documentation update

Updated core feature summaries for REST API and HTTP API APIs. For more information, see [Choosing between REST API and HTTP API APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-vs-rest.html).Managed policy update

Added `acm:GetCertificate` support to the `AWSServiceRoleForAPIGateway` policy. For more information, see [Using service-linked roles for API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/using-service-linked-roles.html).Parameter mapping for HTTP APIs

Added support for parameter mapping for HTTP APIs. For more information, see [Transforming API requests and responses](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-parameter-mapping.html).Disable the default endpoint for a REST API

Added support for disabling the default endpoint for REST APIs. For more information, see [Disabling the default endpoint for a REST API](https://docs.aws.amazon.com/apigateway/latest/developerguide/rest-api-disable-default-endpoint.html).Mutual TLS authentication

Added support for mutual TLS authentication for REST APIs and HTTP APIs. For more information, see [Configuring mutual TLS authentication for a REST API ](https://docs.aws.amazon.com/apigateway/latest/developerguide/rest-api-mutual-tls.html) and [Configuring mutual TLS authentication for an HTTP API](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-mutual-tls.html).HTTP API AWS Lambda authorizers

Added support for AWS Lambda authorizers for HTTP APIs. For more information, see [Working with AWS Lambda authorizers for HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-lambda-authorizer).HTTP API AWS service integrations

Added support for AWS service integrations for HTTP APIs. For more information, see [Working with AWS service integrations for HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations-aws-services).HTTP API wildcard custom domains

Added support for wildcard custom domain names for HTTP APIs. For more information, see [Wildcard custom domain names](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-custom-domain-names.html).Serverless developer portal improvements

Added user management to the administrator panel and support for exporting API definitions. For more information, see [Use the serverless developer portal to catalog your API Gateway APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-developer-portal.html).WebSocket API `Sec-WebSocket-Protocol` support

Added support for the `Sec-WebSocket-Protocol` field. For more information, see [Setting up a \$1connect route that requires a WebSocket subprotocol](https://docs.aws.amazon.com/apigateway/latest/developerguide/websocket-connect-route-subprotocol.html).HTTP API export

Added support for exporting OpenAPI 3.0 definitions of HTTP APIs. For more information, see [Exporting an HTTP API from API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-export.html).Security documentation

Added security documentation. For more information, see [Security in Amazon API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/security.html).HTTP API general availability

Released HTTP APIs in general availability. For more information, see [Working with HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api.html).Reorganized documentation

Reorganized the developer guide.HTTP API logging

Added support for `$context.integrationErrorMessage` in HTTP API logs. For more information, see [HTTP API Logging Variables](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-logging-variables.html).AWS variables for OpenAPI import

Added support for AWS variables in OpenAPI definitions. For more information, see [AWS Variables for OpenAPI Import](https://docs.aws.amazon.com/apigateway/latest/developerguide/import-api-aws-variables.html).HTTP APIs

Released HTTP APIs in beta. For more information, see [HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api.html).Wildcard custom domain names

Added support for wildcard custom domain names. For more information, see [Wildcard Custom Domain Names](https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html#wildcard-custom-domain-names).Amazon Data Firehose logging

Added support for Amazon Data Firehose as a destination for access logging data. For more information, see [Using Amazon Data Firehose as a Destination for API Gateway Access Logging](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-logging-to-kinesis.html).Route53 aliases for invoking private APIs

Added support for additional Route53 alias DNS records for invoking private APIs. For more information, see [Accessing Your Private API Using Route53 Alias](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-private-api-test-invoke-url.html#apigateway-private-api-route53-alias).Tag-based access control for WebSocket APIs

Added support for tag-based access control for WebSocket APIs. For more information, see [API Gateway Resources That Can Be Tagged](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-tagging-supported-resources.html).TLS version selection for custom domains

Added support for Transport Layer Security (TLS) version selection for APIs that are deployed to custom domains. See the note in [Choose a Minimum TLS Version for a Custom Domain in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-custom-domain-tls-version.html).VPC endpoint policies for private APIs

Added support for improving the security of private APIs by attaching endpoint policies to interface VPC endpoints. For more information, see [Use VPC Endpoint Policies for Private APIs in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-vpc-endpoint-policies.html).Documentation updated

Rewrote [Getting Started with Amazon API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/getting-started.html). Moved tutorials to [Amazon API Gateway Tutorials](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-tutorials.html).Tag-based access control for REST APIs

Added support for tag-based access control for REST APIs. For more information, see [Using Tags with IAM Policies to Control Access to API Gateway Resources](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-tagging-iam-policy.html).Documentation updated

Rewrote 6 topics: [What Is Amazon API Gateway?](https://docs.aws.amazon.com/apigateway/latest/developerguide/welcome.html), [Tutorial: Build an API with HTTP Proxy Integration](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-create-api-as-simple-proxy-for-http.html), [Tutorial: Create a Calc REST API with Three Non-Proxy Integrations](https://docs.aws.amazon.com/apigateway/latest/developerguide/integrating-api-with-aws-services-lambda.html), [API Gateway Mapping Template and Access Logging Variable Reference](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-mapping-template-reference.html), [Use API Gateway Lambda Authorizers](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-use-lambda-authorizer.html), and [Enable CORS for an API Gateway REST API Resource](https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-cors.html).Serverless developer portal improvements

Added administrator panel and other improvements to make it easier to publish APIs in the Amazon API Gateway developer portal. For more information, see [Use a Developer Portal to Catalog Your APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-developer-portal.html).Support for AWS Config

Added support for AWS Config. For more information, see [Monitoring API Gateway API Configuration with AWS Config](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-config.html).Support for CloudFormation

Added API Gateway V2 API to the CloudFormation template reference. For more information, see [Amazon API Gateway V2 Resource Types Reference](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-reference-apigatewayv2.html).Support for WebSocket APIs

Added support for WebSocket APIs. For more information, see [Creating a WebSocket API in Amazon API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-websocket-api.html).Serverless developer portal available through AWS Serverless Application Repository

The Amazon API Gateway developer portal serverless application is now available from the [AWS Serverless Application Repository](https://aws.amazon.com/serverless/serverlessrepo/) (in addition to [GitHub](https://github.com/awslabs/aws-api-gateway-developer-portal)). For more information, see [Use a Developer Portal to Catalog Your API Gateway APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-developer-portal.html).Support for AWS WAF

Added support for [AWS WAF](https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html) (Web Application Firewall). For more information, see [Control Access to an API Using AWS WAF](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-control-access-aws-waf.html).Serverless developer portal

Amazon API Gateway now provides a fully customizable developer portal as a serverless application that you can deploy for publishing your API Gateway APIs. For more information, see [Use a Developer Portal to Catalog Your API Gateway APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-developer-portal.html).Support for multi-value headers and query string parameters

Amazon API Gateway now supports multiple headers and query string parameters that have the same name. For more information, see [Support for Multi-Value Headers and Query String Parameters](https://docs.aws.amazon.com/apigateway/latest/developerguide/set-up-lambda-proxy-integrations.html#apigateway-multivalue-headers-and-parameters).Documentation updated

Added a new topic: [How Amazon API Gateway Resource Policies Affect Authorization Workflow](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-authorization-flow.html).OpenAPI support

Amazon API Gateway now supports OpenAPI 3.0 as well as OpenAPI (Swagger) 2.0.Active AWS X-Ray integration

You can now use AWS X-Ray to trace and analyze latencies in user requests as they travel through your APIs to the underlying services. For more information, see [Trace API Gateway API Execution with AWS X-Ray](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-xray.html). Caching improvements

Only `GET` methods will have caching enabled by default when you enable caching for an API stage. This helps to ensure the safety of your API. You can enable caching for other methods by overriding method settings. For more information, see [Enable API Caching to Enhance Responsiveness](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-caching.html). Service limits revised

Several limits have been revised: Increased number of APIs per account. Increased API rate limits for Create/Import/Deploy APIs. Corrected some rates from per minute to per second. For more information, see [Limits](https://docs.aws.amazon.com/apigateway/latest/developerguide/limits.html). Overriding API request and response parameters and headers

Added support for overriding request headers, query strings, and paths, as well as response headers and status codes. For more information, see [Use a Mapping Template to Override an API's Request and Response Parameters and Headers](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-override-request-response-parameters.html).Method-level throttling for usage plans

Added support for setting default per-method throttling limits, as well as setting throttling limits for individual API methods in usage plan settings. These settings are in addition to the existing account-level throttling and default method-level throttling limits that you can set in stage settings. For more information, see [Throttle API Requests for Better Throughput](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-request-throttling.html).API Gateway Developer Guide update notifications now available through RSS

The HTML version of the API Gateway Developer Guide now supports an RSS feed of updates that are documented on this **Document History** page. The RSS feed includes updates made June 27, 2018, and later. Previously announced updates are still available on this page. Use the RSS button in the top menu panel to subscribe to the feed.

The following table describes the important changes to the documentation since the last release of Amazon API Gateway. For notification about updates to this documentation, you can subscribe to an RSS feed by choosing the RSS button in the top menu panel.
+ **Latest documentation update: **December 02, 2025

| Change | Description | Date | 
| --- |--- |--- |
| [Add an API Gateway REST API as a target for Amazon Bedrock AgentCore Gateway](#history) | API Gateway now supports adding a REST API as a target for Amazon Bedrock AgentCore Gateway. For more information, see [Add an API Gateway REST API as a target for Amazon Bedrock AgentCore Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/mcp-server.html). | December 2, 2025 | 
| [Private integration with Application Load Balancer](#history) | API Gateway now supports private integrations with Application Load Balancers for REST APIs. For more information, see [Private integrations for REST APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/private-integration.html). | November 21, 2025 | 
| [Security policies for REST APIs and custom domain names](#history) | API Gateway now supports enhanced TLS security policies on REST APIs and custom domain names. For more information, see [Security policies for REST APIs in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-security-policies.html). | November 19, 2025 | 
| [Response streaming for REST APIs](#history) | API Gateway REST APIs now support progressively streaming response payloads to clients as they become available. For more information, see [Stream the integration response for your proxy integrations](https://docs.aws.amazon.com/apigateway/latest/developerguide/response-transfer-mode.html). | November 19, 2025 | 
| [Developer portals](#history) | API Gateway now supports portals, which are a centralized location for your customers to discover and test your APIs and portal products which represent a service or functionality that you want to share. For more information, see [API Gateway portals](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-portals.html). | November 19, 2025 | 
| [SIGv4a for REST APIs](#history) | API Gateway now supports using Signature Version 4a for REST APIs. For more information, see [API Gateway permissions model for invoking an API](https://docs.aws.amazon.com/apigateway/latest/developerguide/permissions.html#api-gateway-control-access-iam-permissions-model-for-calling-api). | August 19, 2025 | 
| [Routing rules for REST APIs](#history) | API Gateway now supports routing rules for REST APIs using custom domain names. You can dynamically route incoming requests based on HTTP header values, URL base paths, or a combination of both. For more information, see [Send traffic to your APIs through your custom domain name](https://docs.aws.amazon.com/apigateway/latest/developerguide/rest-api-routing-mode.html). | June 3, 2025 | 
| [Added support for dual-stack (IPv4 and IPv6) endpoints](#history) | API Gateway now supports dual-stack endpoints for REST, HTTP, and WebSocket APIs, and custom domain names. For more information, see [IP address types](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-ip-address-type.html). | March 28, 2025 | 
| [Custom domain names for private APIs](#history) | Added support for custom domain names for private APIs. For more information, see [Custom domain names for private APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-private-custom-domains.html). | November 21, 2024 | 
| [Added support for TLS 1.3](#history) | API Gateway now supports TLS 1.3 on Regional REST APIs, HTTP APIs, and WebSocket APIs. For more information, see [Choosing a security policy for your custom domain in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-custom-domain-tls-version.html). | February 15, 2024 | 
| [REST API and WebSocket API console updates](#history) | Updated console information for REST APIs and WebSocket APIs. | December 10, 2023 | 
| [Documentation update](#history) | Updated conceptual information and created new tutorials for data transformations and request validation topics for API Gateway REST APIs. For more information, see [Use request validation in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-method-request-validation.html) and [Setting up data transformations for REST API](https://docs.aws.amazon.com/apigateway/latest/developerguide/rest-api-data-transformations.html). | June 22, 2023 | 
| [Configure DNS failover for a multi-Region API Gateway](#history) | Added support to use Amazon Route 53 health checks to control DNS failover from an API Gateway REST API in a primary AWS Region to one in a secondary Region. For more information, see [Configure custom health checks for DNS failover](https://docs.aws.amazon.com/apigateway/latest/developerguide/dns-failover.html). | October 31, 2022 | 
| [Documentation update](#history) | Updated core feature summaries for REST API and HTTP API APIs. For more information, see [Choosing between REST API and HTTP API APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-vs-rest.html). | May 31, 2022 | 
| [Managed policy update](#history) | Added `acm:GetCertificate` support to the `AWSServiceRoleForAPIGateway` policy. For more information, see [Using service-linked roles for API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/using-service-linked-roles.html). | July 12, 2021 | 
| [Parameter mapping for HTTP APIs](#history) | Added support for parameter mapping for HTTP APIs. For more information, see [Transforming API requests and responses](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-parameter-mapping.html). | January 7, 2021 | 
| [Disable the default endpoint for a REST API](#history) | Added support for disabling the default endpoint for REST APIs. For more information, see [Disabling the default endpoint for a REST API](https://docs.aws.amazon.com/apigateway/latest/developerguide/rest-api-disable-default-endpoint.html). | October 29, 2020 | 
| [Mutual TLS authentication](#history) | Added support for mutual TLS authentication for REST APIs and HTTP APIs. For more information, see [Configuring mutual TLS authentication for a REST API ](https://docs.aws.amazon.com/apigateway/latest/developerguide/rest-api-mutual-tls.html) and [Configuring mutual TLS authentication for an HTTP API](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-mutual-tls.html). | September 17, 2020 | 
| [HTTP API AWS Lambda authorizers](#history) | Added support for AWS Lambda authorizers for HTTP APIs. For more information, see [Working with AWS Lambda authorizers for HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-lambda-authorizer). | September 9, 2020 | 
| [HTTP API AWS service integrations](#history) | Added support for AWS service integrations for HTTP APIs. For more information, see [Working with AWS service integrations for HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations-aws-services). | August 20, 2020 | 
| [HTTP API wildcard custom domains](#history) | Added support for wildcard custom domain names for HTTP APIs. For more information, see [Wildcard custom domain names](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-custom-domain-names.html). | August 10, 2020 | 
| [Serverless developer portal improvements](#history) | Added user management to the administrator panel and support for exporting API definitions. For more information, see [Use the serverless developer portal to catalog your API Gateway APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-developer-portal.html). | June 25, 2020 | 
| [WebSocket API `Sec-WebSocket-Protocol` support](#history) | Added support for the `Sec-WebSocket-Protocol` field. For more information, see [Setting up a \$1connect route that requires a WebSocket subprotocol](https://docs.aws.amazon.com/apigateway/latest/developerguide/websocket-connect-route-subprotocol.html). | June 16, 2020 | 
| [HTTP API export](#history) | Added support for exporting OpenAPI 3.0 definitions of HTTP APIs. For more information, see [Exporting an HTTP API from API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-export.html). | April 20, 2020 | 
| [Security documentation](#history) | Added security documentation. For more information, see [Security in Amazon API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/security.html). | March 31, 2020 | 
| [Reorganized documentation](#history) | Reorganized the developer guide. | March 12, 2020 | 
| [HTTP API general availability](#history) | Released HTTP APIs in general availability. For more information, see [Working with HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api.html). | March 12, 2020 | 
| [HTTP API logging](#history) | Added support for `$context.integrationErrorMessage` in HTTP API logs. For more information, see [HTTP API Logging Variables](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-logging-variables.html). | February 26, 2020 | 
| [AWS variables for OpenAPI import](#history) | Added support for AWS variables in OpenAPI definitions. For more information, see [AWS Variables for OpenAPI Import](https://docs.aws.amazon.com/apigateway/latest/developerguide/import-api-aws-variables.html). | February 17, 2020 | 
| [HTTP APIs](#history) | Released HTTP APIs in beta. For more information, see [HTTP APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api.html). | December 4, 2019 | 
| [Wildcard custom domain names](#history) | Added support for wildcard custom domain names. For more information, see [Wildcard Custom Domain Names](https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html#wildcard-custom-domain-names). | October 21, 2019 | 
| [Amazon Data Firehose logging](#history) | Added support for Amazon Data Firehose as a destination for access logging data. For more information, see [Using Amazon Data Firehose as a Destination for API Gateway Access Logging](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-logging-to-kinesis.html). | October 15, 2019 | 
| [Route53 aliases for invoking private APIs](#history) | Added support for additional Route53 alias DNS records for invoking private APIs. For more information, see [Accessing Your Private API Using Route53 Alias](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-private-api-test-invoke-url.html#apigateway-private-api-route53-alias). | September 18, 2019 | 
| [Tag-based access control for WebSocket APIs](#history) | Added support for tag-based access control for WebSocket APIs. For more information, see [API Gateway Resources That Can Be Tagged](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-tagging-supported-resources.html). | June 27, 2019 | 
| [TLS version selection for custom domains](#history) | Added support for Transport Layer Security (TLS) version selection for APIs that are deployed to custom domains. See the note in [Choose a Minimum TLS Version for a Custom Domain in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-custom-domain-tls-version.html). | June 20, 2019 | 
| [VPC endpoint policies for private APIs](#history) | Added support for improving the security of private APIs by attaching endpoint policies to interface VPC endpoints. For more information, see [Use VPC Endpoint Policies for Private APIs in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-vpc-endpoint-policies.html). | June 4, 2019 | 
| [Documentation updated](#history) | Rewrote [Getting Started with Amazon API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/getting-started.html). Moved tutorials to [Amazon API Gateway Tutorials](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-tutorials.html). | May 29, 2019 | 
| [Tag-based access control for REST APIs](#history) | Added support for tag-based access control for REST APIs. For more information, see [Using Tags with IAM Policies to Control Access to API Gateway Resources](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-tagging-iam-policy.html). | May 23, 2019 | 
| [Documentation updated](#history) | Rewrote 6 topics: [What Is Amazon API Gateway?](https://docs.aws.amazon.com/apigateway/latest/developerguide/welcome.html), [Tutorial: Build an API with HTTP Proxy Integration](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-create-api-as-simple-proxy-for-http.html), [Tutorial: Create a Calc REST API with Three Non-Proxy Integrations](https://docs.aws.amazon.com/apigateway/latest/developerguide/integrating-api-with-aws-services-lambda.html), [API Gateway Mapping Template and Access Logging Variable Reference](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-mapping-template-reference.html), [Use API Gateway Lambda Authorizers](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-use-lambda-authorizer.html), and [Enable CORS for an API Gateway REST API Resource](https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-cors.html). | April 5, 2019 | 
| [Serverless developer portal improvements](#history) | Added administrator panel and other improvements to make it easier to publish APIs in the Amazon API Gateway developer portal. For more information, see [Use a Developer Portal to Catalog Your APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-developer-portal.html). | March 28, 2019 | 
| [Support for AWS Config](#history) | Added support for AWS Config. For more information, see [Monitoring API Gateway API Configuration with AWS Config](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-config.html). | March 20, 2019 | 
| [Support for CloudFormation](#history) | Added API Gateway V2 API to the CloudFormation template reference. For more information, see [Amazon API Gateway V2 Resource Types Reference](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-reference-apigatewayv2.html). | February 7, 2019 | 
| [Support for WebSocket APIs](#history) | Added support for WebSocket APIs. For more information, see [Creating a WebSocket API in Amazon API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-websocket-api.html). | December 18, 2018 | 
| [Serverless developer portal available through AWS Serverless Application Repository](#history) | The Amazon API Gateway developer portal serverless application is now available from the [AWS Serverless Application Repository](https://aws.amazon.com/serverless/serverlessrepo/) (in addition to [GitHub](https://github.com/awslabs/aws-api-gateway-developer-portal)). For more information, see [Use a Developer Portal to Catalog Your API Gateway APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-developer-portal.html). | November 16, 2018 | 
| [Support for AWS WAF](#history) | Added support for [AWS WAF](https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html) (Web Application Firewall). For more information, see [Control Access to an API Using AWS WAF](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-control-access-aws-waf.html). | November 5, 2018 | 
| [Serverless developer portal](#history) | Amazon API Gateway now provides a fully customizable developer portal as a serverless application that you can deploy for publishing your API Gateway APIs. For more information, see [Use a Developer Portal to Catalog Your API Gateway APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-developer-portal.html). | October 29, 2018 | 
| [Support for multi-value headers and query string parameters](#history) | Amazon API Gateway now supports multiple headers and query string parameters that have the same name. For more information, see [Support for Multi-Value Headers and Query String Parameters](https://docs.aws.amazon.com/apigateway/latest/developerguide/set-up-lambda-proxy-integrations.html#apigateway-multivalue-headers-and-parameters). | October 4, 2018 | 
| [OpenAPI support](#history) | Amazon API Gateway now supports OpenAPI 3.0 as well as OpenAPI (Swagger) 2.0. | September 27, 2018 | 
| [Documentation updated](#history) | Added a new topic: [How Amazon API Gateway Resource Policies Affect Authorization Workflow](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-authorization-flow.html). | September 27, 2018 | 
| [Active AWS X-Ray integration](#history) | You can now use AWS X-Ray to trace and analyze latencies in user requests as they travel through your APIs to the underlying services. For more information, see [Trace API Gateway API Execution with AWS X-Ray](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-xray.html).  | September 6, 2018 | 
| [Caching improvements](#history) | Only `GET` methods will have caching enabled by default when you enable caching for an API stage. This helps to ensure the safety of your API. You can enable caching for other methods by overriding method settings. For more information, see [Enable API Caching to Enhance Responsiveness](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-caching.html).  | August 20, 2018 | 
| [Service limits revised](#history) | Several limits have been revised: Increased number of APIs per account. Increased API rate limits for Create/Import/Deploy APIs. Corrected some rates from per minute to per second. For more information, see [Limits](https://docs.aws.amazon.com/apigateway/latest/developerguide/limits.html).  | July 13, 2018 | 
| [Overriding API request and response parameters and headers](#history) | Added support for overriding request headers, query strings, and paths, as well as response headers and status codes. For more information, see [Use a Mapping Template to Override an API's Request and Response Parameters and Headers](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-override-request-response-parameters.html). | July 12, 2018 | 
| [Method-level throttling for usage plans](#history) | Added support for setting default per-method throttling limits, as well as setting throttling limits for individual API methods in usage plan settings. These settings are in addition to the existing account-level throttling and default method-level throttling limits that you can set in stage settings. For more information, see [Throttle API Requests for Better Throughput](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-request-throttling.html). | July 11, 2018 | 
| [API Gateway Developer Guide update notifications now available through RSS](#history) | The HTML version of the API Gateway Developer Guide now supports an RSS feed of updates that are documented on this **Document History** page. The RSS feed includes updates made June 27, 2018, and later. Previously announced updates are still available on this page. Use the RSS button in the top menu panel to subscribe to the feed. | June 27, 2018 | 

## Earlier updates


The following table describes important changes in each release of the *API Gateway Developer Guide* before June 27, 2018.


| Change | Description | Date changed | 
| --- | --- | --- | 
|  Private APIs  |  Added support for [private APIs](apigateway-private-apis.md), which you expose via [interface VPC endpoints](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html). Traffic to your private APIs does not leave the Amazon network; it is isolated from the public internet.  |  June 14, 2018  | 
|  Cross-Account Lambda Authorizers and Integrations and Cross-Account Amazon Cognito User Pool Authorizers  |  Use an AWS Lambda function from a different AWS account as a Lambda authorizer function or as an API integration backend. Or use an Amazon Cognito user pool as an authorizer. The other account can be in any region where Amazon API Gateway is available. For more information, see [Configure a cross-account API Gateway Lambda authorizer](apigateway-lambda-authorizer-cross-account-lambda-authorizer.md), [Tutorial: Create a REST API with a cross-account Lambda proxy integration](apigateway-cross-account-lambda-integrations.md), and [Configure cross-account Amazon Cognito authorizer for a REST API using the API Gateway console](apigateway-cross-account-cognito-authorizer.md).  |  April 2, 2018  | 
|  Resource Policies for APIs  |  Use API Gateway resource policies to enable users from a different AWS account to securely access your API or to allow the API to be invoked only from specified source IP address ranges or CIDR blocks. For more information, see [Control access to a REST API with API Gateway resource policies](apigateway-resource-policies.md).  |  April 2, 2018  | 
|  Tagging for API Gateway resources  |  Tag an API stage with up to 50 tags for cost allocation of API requests and caching in API Gateway. For more information see [Set up tags for an API stage in API Gateway](set-up-tags.md).  |  December 19, 2017  | 
| Payload compression and decompression | Enable calling your API with compressed payloads using one of the supported content codings. The compressed payloads are subject to mapping if a body-mapping template is specified. For more information, see [Payload compression for REST APIs in API Gateway](api-gateway-gzip-compression-decompression.md).  | December 19, 2017 | 
| API key sourced from a custom authorizer | Return an API key from a custom authorizer to API Gateway to apply a usage plan for API methods that require the key. For more information, see [Choose an API key source in API Gateway](api-gateway-api-key-source.md). | December 19, 2017 | 
| Authorization with OAuth 2 scopes | Enable authorization of method invocation by using OAuth 2 scopes with the COGNITO\$1USER\$1POOLS authorizer. For more information, see [Control access to REST APIs using Amazon Cognito user pools as an authorizer](apigateway-integrate-with-cognito.md). | December 14, 2017 | 
| Private Integration and VPC Link | Create an API with the API Gateway private integration to provide clients with access to HTTP/HTTPS resources in an Amazon VPC from outside of the VPC through a [VpcLink](https://docs.aws.amazon.com/apigateway/latest/api/API_VpcLink.html) resource. For more information, see [Tutorial: Create a REST API with a private integration](getting-started-with-private-integration.md) and [Set up a private integration](set-up-private-integration.md). | November 30, 2017 | 
| Deploy a Canary for API testing | Add a canary release to an existing API deployment to test a newer version of the API while keeping the current version in operation on the same stage. You can set a percentage of stage traffic for the canary release and enable canary-specific execution and access logged in separate CloudWatch Logs logs. For more information, see [Set up an API Gateway canary release deployment](canary-release.md). | November 28, 2017 | 
| Access Logging | Log client access to your API with data derived from [\$1context variables](api-gateway-mapping-template-reference.md#context-variable-reference) in a format of your choosing. For more information, see [Set up CloudWatch logging for REST APIs in API Gateway](set-up-logging.md). | November 21, 2017 | 
| Ruby SDK of an API | Generate a Ruby SDK for your API and use it to invoke your API methods. For more information, see [Generate the Ruby SDK of an API in API Gateway](generate-ruby-sdk-of-an-api.md) and [Use a Ruby SDK generated by API Gateway for a REST API](how-to-call-sdk-ruby.md).  | November 20, 2017 | 
| Regional API endpoint | Specify a regional API endpoint to create an API for non-mobile clients. A non-mobile client, such as an EC2 instance, runs in the same AWS Region where the API is deployed. As with an edge-optimized API, you can create a custom domain name for a regional API. For more information, see [API endpoint types for REST APIs in API Gateway](api-gateway-api-endpoint-types.md) and [Set up a Regional custom domain name in API Gateway](apigateway-regional-api-custom-domain-create.md). | November 2, 2017 | 
| Custom request authorizer |  Use custom request authorizer to supply user-authenticating information in request parameters to authorize API method calls. The request parameters include headers and query string parameters as well as stage and context variables. For more information, see [Use API Gateway Lambda authorizers](apigateway-use-lambda-authorizer.md). | September 15, 2017 | 
| Customizing gateway responses |  Customize API Gateway-generated gateway responses to API requests that failed to reach the integration backend. A customized gateway message can provide the caller with API-specific custom error messages, including returning needed CORS headers, or can transform the gateway response data to a format of an external exchange. For more information, see [Setting up gateway responses to customize error responses](api-gateway-gatewayResponse-definition.md#customize-gateway-responses). | June 6, 2017 | 
| Mapping Lambda custom error properties to method response headers |  Map individual custom error properties returned from Lambda to the method response header parameters using the integration.response.body parameter, relying API Gateway to deserialize the stringified custom error object at run time. For more information, see [Handle custom Lambda errors in API Gateway](handle-errors-in-lambda-integration.md#handle-custom-errors-in-lambda-integration). | June 6, 2017 | 
| Throttling limits increase |  Increase the account-level steady-state request rate limit to 10,000 requests per second (rps) and the bust limit to 5000 concurrent requests. For more information, see [Throttle requests to your REST APIs for better throughput in API Gateway](api-gateway-request-throttling.md). | June 6, 2017 | 
| Validating method requests | Configure basic request validators on the API level or method levels so that API Gateway can validate incoming requests. API Gateway verifies that required parameters are set and not blank, and verifies that the format of applicable payloads conforms to the configured model. For more information, see [Request validation for REST APIs in API Gateway](api-gateway-method-request-validation.md). | April 11, 2017 | 
| Integrating with ACM | Use ACM Certificates for your API's custom domain names. You can create a certificate in AWS Certificate Manager or import an existing PEM-formatted certificate into ACM. You then refer to the certificate's ARN when setting a custom domain name for your APIs. For more information, see [Custom domain name for public REST APIs in API Gateway](how-to-custom-domains.md). | March 9, 2017 | 
| Generating and calling a Java SDK of an API | Let API Gateway generate the Java SDK for your API and use the SDK to call the API in your Java client. For more information, see [Use a Java SDK generated by API Gateway for a REST API](how-to-call-apigateway-generated-java-sdk.md). | January 13, 2017 | 
| Integrating with AWS Marketplace | Sell your API in a usage plan as a SaaS product through AWS Marketplace. Use AWS Marketplace to extend the reach of your API. Rely on AWS Marketplace for customer billing on your behalf. Let API Gateway handle user authorization and usage metering. For more information, see [Sell your APIs as SaaS](sell-api-as-saas-on-aws-marketplace.md). | December 1, 2016 | 
| Enabling Documentation Support for your API | Add documentation for API entities in [DocumentationPart](https://docs.aws.amazon.com/apigateway/latest/api/API_DocumentationPart.html) resources in API Gateway. Associate a snapshot of the collection DocumentationPart instances with an API stage to create a [DocumentationVersion](https://docs.aws.amazon.com/apigateway/latest/api/API_DocumentationVersion.html). Publish API documentation by exporting a documentation version to an external file, such as a Swagger file. For more information, see [Documentation for REST APIs in API Gateway](api-gateway-documenting-api.md).  | December 1, 2016 | 
| Updated custom authorizer | A customer authorizer Lambda function now returns the caller's principal identifier. The function also can return other information as key-value pairs of the context map and an IAM policy. For more information, see [Output from an API Gateway Lambda authorizer](api-gateway-lambda-authorizer-output.md).  | December 1, 2016 | 
| Supporting binary payloads | Set [binaryMediaTypes](https://docs.aws.amazon.com/apigateway/latest/api/API_RestApi.html#apigw-Type-RestApi-binaryMediaTypes) on your API to support binary payloads of a request or response. Set the contentHandling property on an [Integration](https://docs.aws.amazon.com/apigateway/latest/api/API_Integration.html) or [IntegrationResponse](https://docs.aws.amazon.com/apigateway/latest/api/API_IntegrationResponse.html) to specify whether to handle a binary payload as the native binary blob, as a Base64-enocded string, or as a passthrough without modifications. For more information, see [Binary media types for REST APIs in API Gateway](api-gateway-payload-encodings.md).  | November 17, 2016 | 
| Enabling a proxy integration with an HTTP or Lambda backend through a proxy resource of an API. | Create a proxy resource with a greedy path parameter of the form \$1proxy\$1\$1 and the catch-all ANY method. The proxy resource is integrated with an HTTP or Lambda backend using the HTTP or Lambda proxy integration, respectively. For more information, see [Set up a proxy integration with a proxy resource](api-gateway-set-up-simple-proxy.md). | September 20, 2016 | 
| Extending selected APIs in API Gateway as product offerings for your customers by providing one or more usage plans. | Create a usage plan in API Gateway to enable selected API clients to access specified API stages at agreed-upon request rates and quotas. For more information, see [Usage plans and API keys for REST APIs in API Gateway](api-gateway-api-usage-plans.md). | August 11, 2016 | 
| Enabling method-level authorization with a user pool in Amazon Cognito | Create a user pool in Amazon Cognito and use it as your own identity provider. You can configure the user pool as a method-level authorizer to grant access for users who are registered with the user pool. For more information, see [Control access to REST APIs using Amazon Cognito user pools as an authorizer](apigateway-integrate-with-cognito.md). | July 28, 2016 | 
| Enabling Amazon CloudWatch metrics and dimensions under the AWS/ApiGateway namespace. | The API Gateway metrics are now standardized under the CloudWatch namespace of AWS/ApiGateway. You can view them in both the API Gateway console and the Amazon CloudWatch console. For more information, see [Amazon API Gateway dimensions and metrics](api-gateway-metrics-and-dimensions.md). | July 28, 2016 | 
| Enabling certificate rotation for a custom domain name |  Certificate rotation allows you to upload and renew an expiring certificate for a custom domain name. For more information, see [Rotate a certificate imported into ACM](how-to-edge-optimized-custom-domain-name.md#how-to-rotate-custom-domain-certificate).  | April 27, 2016 | 
| Documenting changes for the updated Amazon API Gateway console. | Learn how to create and set up an API using the updated API Gateway console. For more information, see [Tutorial: Create a REST API by importing an example](api-gateway-create-api-from-example.md) and [Tutorial: Create a REST API with an HTTP non-proxy integration](api-gateway-create-api-step-by-step.md). | April 5, 2016 | 
| Enabling the Import API feature to create a new or update an existing API from external API definitions. | With the Import API features, you can create a new API or update an existing one by uploading an external API definition expressed in Swagger 2.0 with the API Gateway extensions. For more information about the Import API, see [Develop REST APIs using OpenAPI in API Gateway](api-gateway-import-api.md).  | April 5, 2016 | 
|  Exposing the \$1input.body variable to access the raw payload as string and the \$1util.parseJson() function to turn a JSON string into a JSON object in a mapping template. |  For more information about \$1input.body and \$1util.parseJson(), see [Variables for data transformations for API Gateway](api-gateway-mapping-template-reference.md). | April 5, 2016 | 
| Enabling client requests with method-level cache invalidation, and improving request throttling management.  | Flush API stage-level cache and invalidate individual cache entry. For more information, see [Flush the API stage cache in API Gateway](api-gateway-caching.md#flush-api-caching) and [Invalidate an API Gateway cache entry](api-gateway-caching.md#invalidate-method-caching). Improve the console experience for managing API request throttling. For more information, see [Throttle requests to your REST APIs for better throughput in API Gateway](api-gateway-request-throttling.md).  | March 25, 2016 | 
| Enabling and calling API Gateway API using custom authorization |  Create and configure an AWS Lambda function to implement custom authorization. The function returns an IAM policy document that grants the Allow or Deny permissions to client requests of an API Gateway API. For more information, see [Use API Gateway Lambda authorizers](apigateway-use-lambda-authorizer.md).  | February 11, 2016 | 
| Importing and exporting API Gateway API using a Swagger definition file and extensions |  Create and update your API Gateway API using the Swagger specification with the API Gateway extensions. Import the Swagger definitions using the API Gateway Importer. Export an API Gateway API to a Swagger definition file using the API Gateway console or API Gateway Export API. For more information, see [Develop REST APIs using OpenAPI in API Gateway](api-gateway-import-api.md) and [Export a REST API from API Gateway](api-gateway-export-api.md).  | December 18, 2015 | 
| Mapping request or response body or body's JSON fields to request or response parameters. | Map method request body or its JSON fields into integration request's path, query string, or headers. Map integration response body or its JSON fields into request response's headers. For more information, see [Parameter mapping examples for REST APIs in API Gateway](request-response-data-mappings.md).  | December 18, 2015 | 
| Working with Stage Variables in Amazon API Gateway | Learn how to associate configuration attributes with a deployment stage of an API in Amazon API Gateway. For more information, see [Use stage variables for a REST API in API Gateway](stage-variables.md). | November 5, 2015 | 
| How to: Enable CORS for a Method | It is now easier to enable cross-origin resource sharing (CORS) for methods in Amazon API Gateway. For more information, see [CORS for REST APIs in API Gateway](how-to-cors.md). | November 3, 2015 | 
| How to: Use Client Side SSL Authentication | Use Amazon API Gateway to generate SSL certificates that you can use to authenticate calls to your HTTP backend. For more information, see [Generate and configure an SSL certificate for backend authentication in API Gateway](getting-started-client-side-ssl-authentication.md). | September 22, 2015 | 
| Mock integration of methods |  Learn how to [mock-integrate an API with Amazon API Gateway](how-to-mock-integration.md). This feature enables developers to generate API responses from API Gateway directly without the need for a final integration backend beforehand.  | September 1, 2015 | 
| Amazon Cognito Identity support | Amazon API Gateway has expanded the scope of the \$1context variable so that it now returns information about Amazon Cognito Identity when requests are signed with Amazon Cognito credentials. In addition, we have added a \$1util variable for escaping characters in JavaScript and encoding URLs and strings. For more information, see [Variables for data transformations for API Gateway](api-gateway-mapping-template-reference.md). | August 28, 2015 | 
| Swagger integration | Use the [Swagger import tool on GitHub](https://github.com/awslabs/aws-apigateway-swagger-importer) to import Swagger API definitions into Amazon API Gateway. Learn more about [OpenAPI extensions for API Gateway](api-gateway-swagger-extensions.md) to create and deploy APIs and methods using the import tool. With the Swagger importer tool you can also update existing APIs. | July 21, 2015 | 
| Mapping Template Reference |  Read about the `$input` parameter and its functions in the [Variables for data transformations for API Gateway](api-gateway-mapping-template-reference.md).  | July 18, 2015 | 
| Initial public release |  This is the initial public release of the *API Gateway Developer Guide*.  | July 9, 2015 |