From e3cca2a86266f6e684501c1af552e9592d543162 Mon Sep 17 00:00:00 2001
From: Hunter Mellema <hpm@amazon.com>
Date: Wed, 10 May 2023 10:04:14 -0600
Subject: [PATCH] Add warning about API Gateway request validation limitations

---
 docs/source-2.0/aws/amazon-apigateway.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/source-2.0/aws/amazon-apigateway.rst b/docs/source-2.0/aws/amazon-apigateway.rst
index ecde85623be..8ce9b4c5e52 100644
--- a/docs/source-2.0/aws/amazon-apigateway.rst
+++ b/docs/source-2.0/aws/amazon-apigateway.rst
@@ -296,6 +296,11 @@ Then following example enables request validation on a service:
     This trait should be considered internal-only and not exposed to your
     customers.
 
+.. warning::
+
+    API Gateway request validation uses `JSON Schema <https://datatracker.ietf.org/doc/html/draft-zyp-json-schema-04>`_
+    to validate requests against models and may not meet all the
+    validation needs of your application.
 
 .. smithy-trait:: aws.apigateway#integration
 .. _aws.apigateway#integration-trait: