diff --git a/docs/providers/aws/events/apigateway.md b/docs/providers/aws/events/apigateway.md
index 6bb4034d0..a76d99022 100644
--- a/docs/providers/aws/events/apigateway.md
+++ b/docs/providers/aws/events/apigateway.md
@@ -15,18 +15,19 @@ layout: Doc
 - [API Gateway](#api-gateway)
   - [Lambda Proxy Integration](#lambda-proxy-integration)
     - [Simple HTTP Endpoint](#simple-http-endpoint)
-    - [Example "LAMBDA-PROXY" event (default)](#example-lambda-proxy-event-default)
+    - [Example "LAMBDA-PROXY" event (default)](#example-%22lambda-proxy%22-event-default)
     - [HTTP Endpoint with Extended Options](#http-endpoint-with-extended-options)
     - [Enabling CORS](#enabling-cors)
-    - [HTTP Endpoints with `AWS_IAM` Authorizers](#http-endpoints-with-aws_iam-authorizers)
+    - [HTTP Endpoints with `AWS_IAM` Authorizers](#http-endpoints-with-awsiam-authorizers)
     - [HTTP Endpoints with Custom Authorizers](#http-endpoints-with-custom-authorizers)
+    - [Using asyncronous integration](#using-asyncronous-integration)
     - [Catching Exceptions In Your Lambda Function](#catching-exceptions-in-your-lambda-function)
     - [Setting API keys for your Rest API](#setting-api-keys-for-your-rest-api)
     - [Configuring endpoint types](#configuring-endpoint-types)
     - [Request Parameters](#request-parameters)
     - [Setting source of API key for metering requests](#setting-source-of-api-key-for-metering-requests)
   - [Lambda Integration](#lambda-integration)
-    - [Example "LAMBDA" event (before customization)](#example-lambda-event-before-customization)
+    - [Example "LAMBDA" event (before customization)](#example-%22lambda%22-event-before-customization)
     - [Request templates](#request-templates)
       - [Default Request Templates](#default-request-templates)
       - [Custom Request Templates](#custom-request-templates)
@@ -528,7 +529,7 @@ provider:
     - ${env:MY_API_KEY} # you can hide it in a serverless variable
     - name: myThirdKey
       value: myThirdKeyValue
-    - value: myFourthKeyValue # let cloudformation name the key (recommended)
+    - value: myFourthKeyValue # let cloudformation name the key (recommended when setting api key value)
   usagePlan:
     quota:
       limit: 5000