diff --git a/packages/aws-cdk-lib/aws-apigatewayv2/README.md b/packages/aws-cdk-lib/aws-apigatewayv2/README.md
index 9c37cb51b7535..e3e3d515db9f4 100644
--- a/packages/aws-cdk-lib/aws-apigatewayv2/README.md
+++ b/packages/aws-cdk-lib/aws-apigatewayv2/README.md
@@ -483,7 +483,10 @@ Common config for both HTTP API and WebSocket API
 Represents a collection of route settings.
 
 ```ts
+declare const api: apigwv2.HttpApi;
+
 new apigwv2.HttpStage(this, 'HttpStageWithProperties', {
+  httpApi: api,
   throttle: {
     rateLimit: 1000,
     burstLimit: 1000,